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FILEVISION™ 
Words, numbers, pictures : think & work in all 3. 


VISUALIZE INTEGRATED: 
Planning, Tracking, Scheduling, Locating, Deciding, Discovering 
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® put pictures and information together in a filing system 

e draw lines, rectangles, squares, ovals, circles, and free-form shapes 

e stretch, shrink, reshape, shade, cut, paste, move, and copy 

e overlap, hide and highlight 

e change and create symbols 

® print lists, labels and pictures 

e change print styles and sizes 

e record, edit, and interrogate visual, numeric and written information 


THE SALES EDGE™ 
Business Strategy Software 
PERSONAL POWER WITH A STROKE OF GENIUS 


e A guide to the business jungle with step-by-step strategies 

e Manage people, not just words and numbers 

e Evaluate human factors that affect your decisions 

e Discover the best tactics to stack those factors in your favour 
e Obtain a printed 3-10 page analysis of your business situation 
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PLUS 
LANGUAGES GRAPHICS GAMES 
e Macforth e Mac the Knife © Millionaire 
e Aztec C Compiler e Cut 'N’ Paste e Macsiots 
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EDITORIAL 


he news that Apple had 
brought out the Macintosh with 
a vastly improved memory 
came as something of a surprise. No 
one in Australia expected the 
machine to be available until early 
next year. 

With this advanced step forward 
Apple are securing the position of 
the Macintosh in no uncertain way. 

It is already known that Apple 
expect that in Australia alone the 
Macintosh will next year account for 
5Q percent of their turnover. Which is 
an awful lot of Macintoshes. 

Certainly it is making a big impact 
on the educational market, but what 
has surprised us is the way it is 
being snapped up by businessmen 
and computer hobbyists. 

| must admit | was rather sceptical 
about the Macintosh and its chan- 
ces of breaking into the big time 
when it was first launched. | no lon- 
ger harbour such doubts. 

Two elements seem to have been 
involved in making the Mac the 
major success that it is — apart from 


its technical excellence and superior 
performance. 

The first is the problem that IBM 
are having with the machine they 
launched as the PCjr. It really does 
not matter what attempts they make 
to alter and improve this machine — 
the end result is always going to look 
like a muddle. And the American 
public, with immense good sense, 
are staying well away and, in many 
cases, buying the Macintosh instead. 

The second development is the 
flood tide of programs that have 
been released. At the beginning it 
could have been thought that the 
Apple Macintosh programs were 
more in the minds of their PR com- 
panies than reality. 

And at the beginning that may 
have been true. Now, however, we 
see new programs being released 
almost every day of the week. And as 
each program finds its niche, so the 
likelinood of the Macintosh becom- 
ing the preeminent computer in its 
range increases. 


In fact, thinking about it, the 


Macintosh doesn't fit into any range. 
It stands uniquely alone. The only 
valid comparisons would be with the 
Lisa. 

Because of all this excitement 
about the Macintosh, starting with 
the next issue we will be running an 
Australian Macintosh supplement 
with each issue. We hope you will 
enjoy it. O 


LETTERS 


Dear Sir, 


On behalf of my fellow members 
of the Brisbane Medfly Users Group, 
can | ask you to break the suspen- 
se? We have all been waiting eagerly 
for your article on the Medfly, the 
more so because of your dark hints 
about its nativity. 

While we are inclined to agree 
with your comments about support 
from the manufacturer, the fact 
remains that Medfly is one of the few 
Apple compatible machines that is 
not a “fake”, and is reasonably well 
constructed and documented. 
Furthermore, as far as | know, it is 


also the only one that is significantly 
more powerful, and actually has an 
implementation of CP/M 3. avail 
able. 

The fact that yours is one of the 
few magazines that doesn’t pretend 
that compatibles don't exist has 
impressed us; | hope you will bear 
the fact in mind when contemplating 
policy. Software reviews which indi- 
cate Medfly compatibility, occasional 
articles specific to us would be 
welcomed. In addition, could | enter 
a plea that CP/M isn’t forgotten? 

some of your correspondents may 
dislike it, but CP/M users with a 65@2 
In their machine still constitute a very 
large proportion of the total. DOS 
software isn’t all! 

| would be grateful too, if you 
could include the name and address 
of the Brisbane Medfly Users Group 
in your next listing of user groups, 
(120 Highgate St, Coopers Plains, 
Qid 4198, for those who are interes- 
ted). The group has been operating 
on an informal basis for about a year 


now. Membership has risen to just 
under 29, and is steadily growing. 
The group is in touch with overseas 
groups, including two in the USA, 
and is looking forward to being able 
to expand its contacts. 

. At present, we can offer members 
help in setting up and choosing 
software; for the future, we are hop- 
ing to establish a library of public- 
domain software for the Medfly. 


Dr K J Walker 
Coordinator 
Coopers Plains, Qld 


Ed: A fair letter. As it happens, | flew 
back to Hong Kong with one of the 
people who are behind MedFly and 
he told me the machine is now being 
sold into the People’s Republic of 
China. 

But your letter, in a_ sense, 
answers its own questions. The 
reason we have never reviewed the 
MedFly (although | have used one in 
Hong Kong) is because we have 
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never been offered one for test. 
Secondly, the number of MedFly 
users in Australia is miniscule com- 
pared to the number of Apple users 
(genuine and fake). Obviously we are 
catering for the majority of our 
readers. | have nothing against the 
MedFly (except for its damn silly 
name which is a schoolchild’s pun 
referring to the invasion of the 
Mediterranean Fruit Fly into the 
apple orchards of California) but | 
must state its documentation is so 
bad as to be ludicrous and the 
dealer network in Australia, vestigial. 
Nope, | can’t see us catering to the 
needs and desires of MedFly users 
until and unless someone shows me 
they are a significant part of the 
market. For MedFly users who do not 
want to remain out there on their 
own the offer from the Brisbane 
MedFly Users’ Group will no doubt 
initiate some activity. 


Dear Sir, 


| have read with interest your arti- 
cle in the Weekend Australian on 
August 4-5 re advice on purchasing 
a computer. 

My wife and | operate a small cof 
fee shop employing four people. 

My turnover is between $3,500 to 
$4500 per week, all sales are cash 
over the counter, so we have no 
debtors. 

We have approximately 35 sup 
pliers, some cash, some account. 

Could you please advise us as to 
a Suitable computer and_ the 
necessary software and or other 
equipment that would be necessary 
to take out following information: 

1. Total sales per week and month. 


2. Total purchases as well as 
individual totals. 

3. Percentages on purchases, sales, 
wages, etc and against rent, plus any 
other information you may feel is 
necessary, or any other information 
that you Know is available that is 
relevant. 

Whilst being human | do not wish 
to spend a lot of money, and do not 
know anything about computers. 
However | would be prepared to 
spend approximately $2,000 if the 
above information could be supplied 
simply without the tedious job of 
manual additions etc. 

Hoping you are able to assist. | 
enjoyed reading your article, even 
though | am a raw recruit and have 
never operated any computer. 


Frank C. Koschel 
North Mackay, Qld 


Ed: /t is very easy to give glib 
answers when you do not have the 
full story. But from the information 
given an Apple Ile using a Cashbook 
produced by Zofarry with an el 
cheapo dot matrix printer would fill 
the bill Cost a bit more than $2,099, 
though. Best bet is to buy a good 
second hand Apple with the same 
program. 5 


Mr Gareth Powell, 


May | say how much | like your 
page. | am a freelance technical 
writer and | have been using an 
Apple IIl+ with Zardax as a word pro- 
cessor for three years. | am very 
Satisfied with the combination. 

There are several Nundreds of 
hours of work on my Zardax files and 
| would like to upgrade to IBM, Lisa 
or Macintosh, but every enquiry | 
have made seems to indicate that if | 
wish to access this bank of work and 
bring it up for including in the book, | 
am stuck with the old system based 
on the 6592 assembly language? 

All | ask ts that | can save retyping 
by transferring text to the new format. 
Everyone says it cannot be done. 
Cannot X3!!!? | am sure that many of 
your readers are in the same position 
but it seems to be a taboo subject for 
all computer Journos. Please why? 

Looks that | will have to go to 
Apple lic if | want a new trick? 

Some years ago as Mr Remington 
Rand in Australia, | introduced the 
portable typewriter to retail stores. 


Previously all typewriters were direct 
sales from the manufacturers. It was 
a mini PC story, suddenly portable 
typewriters as a homeware product 
boomed on HP for the first time. One 
observation was that the salesmen, 
and even the best, never seemed to 
lower themselves to try and learn 
how to type. It was accepted that if 
you bought one, learning to use it 
was nothing to do with them. Some 
actually could peck out “The quick 
brown fox...“ on two fingers; big 
deal! Perhaps this attitude is repeat 
ing itself in the PC boom? 


Malcolm Goldfinch 
Woollahra, NSW 


PS: Although | was a journalist 
before the war and for a while after, | 
somehow was the first person in 
commercial computers in Australia, 
lecturing on the only non-laboratory 
computer, Univac, to post graduate 
courses at the Adolf Baser Computer 
Laboratory at the University of Syd 
ney in 1956. 


Ed: With that wealth of experience, 
he is asking me? | cannot see what 
the problem is with the text files 
created by Zardax A text file is a text 
file is a text file as Alice B. Toklas or 
Gertrude Stein (or possibly both) 
used to Say. | transfer text files back 
and forth from all sorts of machines 
by pretending | am flashing them 
down the telephone line. For exam- 
ple, this limpid prose is being written 
on an Apple and will shortly appear 
on a Wang. To do this | transmit it 
through a communications package 
and a CCS board down through an 
RS 232 port and into the Wang. The 
Wang thinks the signals are coming 
in through its telecommunications 
program, the Apple thinks it Is 
transmitting information down the 
telephone. 

This works nearly every time pro- 
viding you are sending text files that 
have been written in ASCII, or some- 
thing very close, which is true of 
almost every word processing pro- 
gram that | know. 

You may have a few problems 
with line length so you get the 
occassional unwanted paragraph 
inserted but that is pretty easy to fix 
once the copy has been transmitted. 

| do not know what XI!!! means but 
it sounds rude to me. 


NEWS 


Apple news 


ontrol Data have been in com- 
Cotter education and computer 
from the 
beginning. Now, in Australia, Control 
Data Publishing - a new branch of 
the company — has released a flood, 
a positive deluge, of programs for the 


publishing almost 


Apple. These programs are. all 
educational and appear under the 
generic title of “Courseware”. They 
allow your Apple to take you through 
the rigours of a number of subjects 
such as Basic Numeric Facts, 
Spanish Travel, Spanish Shopping, 
Spanish Classroom, Polynomials, 
Building Relationships, Forming 
Positive Behaviour and Physics. 

All of the titles are competently 
written and produced, albeit with an 
American slant. New titles are being 
Originated in Australia which we 
should see in the coming year. 


Victorian first 


In August 1972, Burwood High 
School in Victoria was the first Vic- 
torian high school to have its own 
computer. 

By August 1978, there were three 
Victorian high schools with their own 
computers. 

By June 1984 all of the more than 
329 high schools and more than 14@ 
technical colleges in Victoria had 
their own computers. Most of them 
were Apples. 

The Education Department in Vic- 
toria is, perhaps, the most computer 
oriented of all Australian education 
departments and has set up a joint 
software production house to make 
sure that the software is aS good as 
the hardware. 


An Apple for the teacher 


Apple has provided a_ twenty 
machine Apple II family personal 
computer laboratory to assist in the 
training of teachers for the Associa- 
tion of Independent Schools. 

The 2@ computers have been 
installed in a special computer 
classroom at the northern Sydney 
girls school, Abbotsleigh. During 
school hours, the classroom will be 
used by the 1,09@ odd students, but 
is also expected to become a major 
community resource for northern 
Sydney suburbs. The installation is 
valued at more than $26,000. 


More for the Lisa 


Apple has introduced Lisa 7/7, an 
integrated software package for the 
Lisa personal computer than com- 
bines seven powerful and diverse 
business functions. 

Lisa 7/7 includes project manage 
ment, word processing, spread 
sheet, data communications, data 
base, business graphics, and struc- 
tured graphics. It follows closely in 
the steps of Lotus 1-2-3, Symphony, 
Appleworks, Framework and many 
others. This package allows a buyer 
to cover most requirements with one 
software purchase. 

The sensible move would be for 
Apple to put all of this software into a 
series of chips so that the Lisa 
comes totally configured and ready 
for action. 

Our guess is that this will indeed 
happen in the early part of 1985. 

For the moment the package is 
only available in software at a price 
of something under a_ thousand 
dollars. Which, considering the 
scope of the package, is a bargain 
indeed. 


The painting mouse 


Ahware (where do they think up 
these names?) of Danville, California 
have released a Mouseprint program 
which allows Apple’s Mousepaint 
program to print directly on printers 
other than Apple’s Dot Matrix or 
Imagewriter. 

This is no great deal, as far as we 
can ascertain, because all that Is 
happening is you are getting a 
graphics dump which is already an 
essential part of Apple’s Mousepaint 


program. Versions of Mouseprint are 
available for most popular printer 
interface combinations. 

Printers currently Supported in- 
ciude the Epson, Okidata, C. Itoh 
and Star Micronics lines. Interfaces 
Currently Supported include Epson, 
Grappler, Pkaso, Prometheus, Mic- 
robuffer, Graphicard, Apple and 
Printerface. 

Available at US$22.95 from 
Ahware, 895 Luz Court, Danville, CA 
94526, USA. On the other hand you. 
can save yourself the money, get out 
your printers book of instructions 
and write a little driver program 
yourself. 


Macintosh counts 


A new line of accounting software 
designed specifically for the Apple 
Macintosh will be released by 
Interactive Applications in early 
November. The three packages are 
Accounts Receivable, General 
Ledger and Stock Control. Each is a 
stand alone system, and is written to 
function on a standard Macintosh 
with a single 40@ KB diskette. They 
make extensive use of the mouse, 
are written in Microsoft BASIC, and 
require little or no on site installation, 
training or Support. 

However, the amount of account 
ing you can do on the Macintosh 
until the new memory chips become 
available is fairly limited. OK if you 
are a small business or self 
employed. Not much cop for a full 
scale business. 

Apple have recently introduced 
Pascal for the Macintosh, and it will 
be available in Australia in the next 
few months. 

This is fairly logical as the major 
sales of the Macintosh todate have 
been to educational establishments 
and Pascal was originally designed 
as a learning language for students. 
Launching the Macintosh without 
Pascal might be regarded by harsher 
critics than us as a marketing 
hiccup. 

The program is referred to as Ins- 
tant Pascal, and is designed as a 
student's aid giving instant feedback. 

The program checks each Pascal 
statement for proper syntax as it is 
entered, and displays any unrecog- 
nisable text in hollowed lettering. At 
any time, the users can ask Macin- 
tosh Pascal to check the entire pro- 


gram for consistency and proper 
syntax. 

It is claimed Macintosh Pascal 
contains virtually all of the functions 
and standards of American National 
Standard Pascal and is compatible 
with Lisa Pascal. 

But is it as fast as Turbo Pascal, 
we hear a voice ask. Let uS move on 
to the next subject. 


Chip checker 
This is a double goody. 
Australian Video Presentations 


have brought out a Chip Checker for 
Apples and Apple compatibles. 
Designed as a peripheral card, the 
chip checker checks, verifies and 
identifies all TTL IC's. 

It is slot independent and is con- 
nected via a ribbon cable to a zero 
insertion force socket placed outside 
the computer. Used in conjunction 
with the software provided, the Chip 
Checker will test standard TTL (54/ 
740 series), low power Schottky TTL 
(54/74LS series), Schottky clamped 
TTL (54/748 series), low power TTL 
(54/74L series), high speed TTL (54/ 
74H series) and TTL equivalent 
CMOS devices (54/74C series). 

The Chip Checker not only tests 
for complete failure with the opera- 
tion of an IC but by means of a loop 
routine will also test for chip 
instability and respond accordingly. 

lf a chip has been inadvertently 
scrubbed (or advertently — is there 
such a word? — scrubbed by a 
manufacturer who wants to hide 
what works where) and left with no 
means of identification, the Chip 
Checker will search and_ identify 
which type of IC it is. The Chip Chec- 
ker has a recommended retail price 
of less than $300. 

Actually, we have such a chip 
checker which we bought in Hong 
Kong. There are several versions 
available. Ours seems to work on the 
Same basis as the Video Presen- 
tations board but it is not a copy. 

These boards are amazingly use 
ful if you have a problem which you 
have tracked down to being some 
where amongst those serried ranks 
of chips. It will test each chip and 
give you the good oll. 

We can't see it being bought by 
every computer user but it should 
find a ready sale in schools, and with 
happy home hackers like us. O 
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Word processing 


at home: 


BE ach year thousands of young 
students leave school to find 


themselves on the dole. For 
those with typing ability, an Apple 
computer may seem to offer the key 
to a lucrative cottage industry; word 
processing. However, the business is 
not as easy as it sounds. Here is the 
experience of one person who took 
advantage of this cottage industry 
and now earns a respectable income 
with an Apple II+. 

Joe Blake of Perth, Western 
Australia, spent sixteen years in the 
Army with his last nine years in the 
psychology section. One day in 1979 
Joe experienced his first computer. 
“It was a pivotal point in my life,” Joe 
recalls. “| was out for a short stroll 
and passed a small handwritten sign 
at the city hall saying ‘computer 
display inside’. Walking inside, the 
first thing | heard was the Flight of 
the Bumble Bee played on an Apple 


a profitable 
enterprise 


by Donald E Pugh 


17 Irvine St 
Peppermint Grove, WA 6011 


computer with an ALF-~ music 
synthesiser card.” 

Joe thought “Wow, that’s really 
something.” Next to the Apple was a 
Tandy computer that was_ talking. 
Joe, talented folk musician, medi- 
tated: “Which do | want, a computer 
that talks or a computer that plays 
music?”. Joe debated the problem 
for five minutes, then asked the 
Apple dealer “How much?” A week 
later Joe owned an Apple computer 
system. 


‘An Apple computer may 
seem to offer the key to a 
lucrative cottage industry’ 


Joe entered his future typing 
career in 198Q. One of his friends at 
the local Brisbane Apple Users Club 
was lan Phillips, the author of the 
Zardax word processor. lan first 
introduced the idea of word proces- 
sing to Joe. A friend of Joe’s was 
also learning typing and launched a 
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career typing theses at the local 
university. Following a_ discharge 
from the Army, Joe was also looking 
for an alternative job. He had found a 
low rental house in Perth and already 
possessed the Apple. Because he 
read avidly in a variety of university 
fields and was a good speller, word 
processing for university students 
seemed an ideal career. 

Following an extensive market 
survey, he purchased a NEC 
Spinterm printer for $4,000. He also 
purchased Zardax, from his friend 
lan Phillips. Joe commenced working 
with this program and _ gradually 
developed real competence after 
numerous phone calls back and 
forth to lan in Brisbane. 

Joe’s first typing contract was with 
the previous tenant of his house. Joe 
had mentioned he was typing theses 
and essays. “Before | knew it,’ Joe 
states, “this fellow who was majoring 
in psychology employed me to do all 
his typing during the next four years.” 

Joe thought it would take at least 
a year before he became known and 
to build up a clientele. It has 
probably taken two to three years. 
Joe’s main advertising is by word of 
mouth, although he runs a com- 
mercial advertisement in the Yellow 
Pages in the typing section. He also 
advertises at the University Guild as 
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an experienced typist and hands 
around his business cards freely. But 
he notes: “If it is possible to get a 
couple of really good customers who 
are convinced of your work, then 
business keeps flowing in second, 
third, fourth and even fifth hand. One 
cannot buy this sort of recom- 
mendation for love or money.” 

Joe has now been typing theses 
for the university for a period of four 
years. He finds: “| start from the 
beginning of July getting enquiries 
for theses. By August a thesis might 
come in. By September/October |’m 


overloaded with work and turning it 


away to two or three other typists. 
This work load continues up to 
Christmas. The slack period is during 
the Christmas holidays and the 
autumn period.” 

Joe finds that fifteen to twenty 
page essays are his real money 
makers. He gets immediate payment, 
while typing a thesis may delay his 
income for several months. 

Joe attributes his success to 
excellent quality and low prices. He 
recommends’ that high quality 
typewriter Output is essential, par- 
ticularly for theses. He advises: “It’s 
necessary to read anything that one 
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can lay one’s hands on. | type essays 
on dramatic art, chemistry, lobsters, 
botany reports, ecological impact 
studies — you name it, I’ve done it. | 
often interpret poor handwriting and 
it helps to have a background in the 
Subject.” Consequently it is essential 
to read broadly. Joe subscribes to 
“Scientific American’ and_= similar 
magazines. 

Joe also recommends that a basic 
understanding of Latin is invaluable 
for typing for doctors and_ for 
botanists. It assists in making 
informed guesses at the meaning of 
various terms. With the word 
processor, of course, it is always 
possible to put a question marx after 
the word and to correct it at a later 
date. It is helpful, though to be able 
to guess the word from the context. 
This saves time in corrections and 
makes it possible to return a piece of 
work with hardly any errors. 

Joe is very pleased with the 
tumbling prices for Apple equipment. 
Also the price of quality daisywheel 
typewriters has really dropped. This 
has made entry into the word 
processing field easier for others. Yet 
Joe still finds there are thousands of 
people around with typing expertise, 
hundreds of people with computer 
expertise but few who can make 
these two skills come together to 
produce a quality result. 

He also finds it useful to have 
some skills in Computer repair and 
equipment maintenance. Joe !Is able 
to replace chips on his computer 
and regularly winds his ribbons for 
the NEC Spinterm printer. 

Joe has recently purchased a 
MedFly, an Apple compatible com- 
puter. He now rents his older Apple 
and office space to another typist. 
They charge by the keystroke 
(business, one cent every five 
Strokes, students, one cent every 
seven strokes), and find they cannot 
keep up with the business. 

The secrets of running a home 
word processing business and of his 
success, Joe concludes, are: low 
typing costs, quality equipment, low 
overheads, and provision of error 
free competent service. Joe clearly 
provides all these services in a 
friendly way. O 


Joe Blake, Proword Enterprises 
(99) 381-1980 


There really is a difference 
in diskette brands. 
It’s in the way they are 
made. 
Because the computer 
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When you can't ee 
iskettes, at Nashua we 
afford mistakes. coke fr andiounda 


consistency. 
Here’s how we do it. 
Quality Circles. 

At Nashua we've found 
the best way to attain this 
‘consistency’ is to ensure 
that at each stage of 
production our diskettes 
are statistically checked to 
make sure the quality is 


‘built-in’ every step of the 
way. - 

Rather than long 
production lines, we have 

| ‘Quality Circles’ — small 
groups of people whose job 
it is to make sure that each 
Nashua diskette is right in 
the first place. 

The result is a diskette 
with such consistency, that 
it is chosen by those people 
who can’t afford mistakes. 

Phone Sydney 958 2044, 
Canberra 47 0511, 
Melbourne 428 0501, 
Brisbane 369 4244, 
Adelaide 42 0021, Perth 
328 1888, Darwin 816204, 
Auckland 77 5468, 
Wellington 85 1965, 
Christchurch/Dunedin 
Whitcoulls Ltd, PNG 
25 6766. 


There really is a difference. 


Ruwald & Skinner 402 NA/A 
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Repairing your Apple-Part II 


tic diagnostic trouble shooting 

we suggested in our last Issue, 
you have to move on to slightly more 
complicated matters. The amount of 
equipment you need is absolutely 
minimal. What you do need most of 
all is organisation. You simply cannot 
have enough little boxes in which to 
put screws, IC chips and bits and 
pieces. Once you get them mixed up 
you will have the devil's own job to 
Start off with. When you are going to 
repair your Apple the first thing you 
need is a big soft surface. A large 
towel laid flat on a desk will be ideal. 
The second thing you need is a lot of 
light. It depends on your age and the 
strength of your eyesight but | find 
the minimum is one really good desk 
light and a powerful torch. You may 
need less if you have the eyes of a 
young Augus. 

You will need a pencil and paper 
to make notes and sketches of 
everything you take out and where it 
fits. You will also need a Phillips 
head screwdriver in order to remove 
some of the screws at the bottom of 
the machine. As well, you will need a 
small flat bladed screwdriver to deal 
with some of the non-Phillips screws. 

Most professionals prefer to yank 
out the ICs using a screwdriver. This 
way can lie disaster. It is much easier 
for you to use an IC puller which 
costs almost nothing. They are avail 
able at Tandy’s for about $3. 

Now let us presume your initial 
run through the machine as listed in 
the last issue has not worked. That is, 
you have removed all the boards and 
tested to see if the machine will start 
Then you have to take your Apple 
apart. It really is not that difficult. First 
of all approach it step by step. — 

Step one: 

Turn off the 

computer. 


O nce you have done the simplis- 


power at the 


‘Tf you use brute force and 
ignorance you bend the 
pins of the chip’ 


Open the lid and touch the power 
supply in the lefthand corner (it Is 
the big gold or silver box) with your 
bare hand. You will not feel any 
shock but it will automatically earth 
any static electricity in your body. 
Step three: 

Remove the socket from the 
mains. Then to be absolutely sure, in 
our old mother worrying about the 
child damaging himself mode, pull 
the power plug from out of the back 
of the computer. This means your 
computer cannot possibly give you a 
shock, which is a bad thing, or you 
pull out boards when there is power 
going through the computer. Which 
iN Our Opinion is even worse. Start 
removing the peripheral boards one 
by one. As you remove them write 
down on a piece of paper where they 
were and the direction in which they 
were pointing. Most peripheral 
boards appear to be fairly logical so 
the long end faces towards the 
keyboard and the short end with the 
contacts towards the back of the 
machine. But not all. There is a prin- 
ter interface made in New Zealand 
which is almost exactly the reverse. 
So you have to check them with 
great care. Take out your peripheral 
cards one by one, starting with slot Q, 
write down what they are and the 
direction in which they were facing, 
and lay them very carefully and gen- 
tly down on a large piece of soft 
cloth in their correct order and facing 
in their right direction. 

It is possible that the order will be: 

Slot@ a 16K RAM add on board 

Slot 1 a printer interface 

Slot 3 an 8M column board 

Slot 6 a disk drive. 

You may have many more boards 
than that. You may have fewer. Dis- 
connect them and take them out very 
carefully. You should now have no 
wires attached to your machine what 
soever. Check that this is so. 

Step four. 

Turn the machine up-side-down 
so it is resting on the soft towel sur- 
face on the desk. Start to remove the 
Phillips Nead screws from your 
machine. If you have a real Apple 


there will be ten Phillips head screws 
to remove. If you have a fake Apple 
you may find you have a lot fewer. 
Most fake Apples come with a shor 
tage of screws. 

The first two screws to remove are 
at the back edge of the bottom plate. 
That is the edge furthest away from 
the keyboard and these two screws 
are on each side behind the rubber 
plate on the extension. Note most 
carefully there are several other 
screws in line with the rubber feet. In 
fact there are screws all around the 
centre of the base board. Do not 
remove these or you will spend a 
considerable time trying to sort it all 
out again. Remove only the two 
screws located behind the rubber 
feet. 

As you remove the screws do it 
most carefully with a steady pre 
ssure. Make sure you have a good 
condition Phillips screwdriver. (There 
are others called Pozidrive which 
may not fit exactly.) You want the per- 
fect match between screwdriver and 
screw. Then ease those two screws 
out. Once they are out put them car- 
efully into one of your containers. 
Then along the edge on each side of 
the machine are two screws. These 
four screws in all, are removed next 
and placed in the same container. 
Finally there are four Phillips head 
screws along the front edge of the 
bottom plate and these are located 
in semicircular notches. When you 
take these out, you will almost cer- 
tainly find they have a lock nut (a sort 
of serrated edged washer) fitted to 
them. Make sure you do not lose 
them. Now you should have ten 
screws set to one side in a Cup and 
your machine is ready to be taken 
apart. 
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Now with great care grasp the 
whole of the Apple housing and the 
bottom plate with both hands and 
keep the two sections firmly clamped 
together as you turn the computer 
face up again. Do not let it slip and 
do not let the two parts come 
undone. Put your hands inside the 
housing, grasping the housing close 
to the keyboard. As you lift up you 
will see a Space of a few centimetres 
and inside that space you will see a 
coloured ribbon cable which goes 
from the keyboard to the mother 
board. It consists of a multitude of 
cables stuck together and is about 
three centimetres wide and has an 
absolutely flat appearance. It looks 
more liké a ribbon than a cable. Note 
carefully how this cable is attached 
to the mother board. 


‘A large towel laid flat on 
a desk will be ideal’ 


This flat cable is attached to the 
mother board by an IC. It will need to 
be removed extremely carefully. 
Especially the first time you do it. It is 
almost impossible to get an IC puller 
in to take out this particular chip. 
Therefore you are going to have to 
insert the flat bladed screwdriver 
from the front end of the keyboard 
through the gap you have created by 
lifting the body. Now insert it bet 
ween the socket and the IC ana twist 
the screwdriver very slightly side 
ways and the IC will just start to lift. 
Rake out the screwdriver and lower 
the front of the machine. Now work- 
ing from inside the computer and 
using a torch put the flat end of the 
screwdriver between the chip and 
the socket again and make a half 
turn. The chip will lift out of the soc- 
ket at that end. Repeat the process 
two or three times until the chip 
comes out very easily. 

Notice that if you use brute force 
and ignorance you bend the pins of 
the chip. You can probably straighten 
pins on chips about three times 
before they snap off but do not bet 
on it. And once you have bent them 
they are extremely difficult to get 
back into their sockets. So it is best 
to approach it very slowly and very 
carefully until you have got that chip 
removed from its socket. With your 
pencil and paper note carefully the 


way that the ribbon aligns with the 
chip before it goes into its socket. 
Otherwise, like many other home 
repairers (including myself) as sure 
as god made little Apples you are 
one day going to try and put It in the 
wrong way around. And the key- 
board will not appreciate it) You can 
now lift the whole of the top of the 
Apple away from the base leaving 
the mother board in all its naked 
beauty. 

The mother board is mapped out 
just tke a city and you can see inter- 
sections, maps and numbers printed 
on it in white ink. The numbers 1 to 
14 are printed in white letters across 
the front of the board. Using this 
extremely simple method of iden- 
tification you can find your way to 
any part of the board. For example 
C2 is an IC which has a number prin- 
ted underneath it. That number its 
748195 IC. Easy to find. You follow 
an imaginary line across the board 
from left to right at location C. Count 
along 2 and there is the IC. 

This is where | diverge from all 
other people recommending working 
on an Apple. It seems to be general 
practice at this stage to teach people 
to be able to remove the mother 
board from the base plate. | cannot 
honestly think of one good reason 
why you should ever want to do so. If 
the computer is so damaged that the 
mother board has to come away from 
the base board then it is not a job for 
the happy home hacker. It is a job for 
a serious professional. And in all fair- 
ness, in all the time | have been 
working on Apples | have never seen 
a situation where | have had to lift the 
mother board away except where | 
have been replacing a very indif- 
ferent piece of Hong Kong and 
Taiwanese soldering with a superior 
article. That should not happen to 
yOu. 


‘Then you have to take 
your Apple apart’ 


You will notice on the right hand 
side there is a two prong plug with a 
white plug on it with two wires lead- 
ing to a mickey mouse loudspeaker 
on the other side of the computer. 
These rarely, if ever, go wrong. If they 
do, they can be replaced for a few 
dollars. It may be when you do, you 


The Apple motherboard 


would like to get yourself something 
better in the line of speakers. On the 
other hand you may find if you do, 
the noise will be deafening. With me 
itis an invariable practice to change 
the loud speaker and put a volume 
control on so | can have it at full chat 
when | am playing Star Wars and 
extremely quiet when | am playing 
with my word processor. It is all a 
matter of taste. 

If you are going to play around 
with the speaker, bear in mind it is 
glued in. It is relatively easy to lever it 
up with your straight screwdriver and 
glue it back again with rubber or 
Super glue. 


‘This means your 
computer cannot possibly 
give you.a shock’ 


Now we come. to 
shooting. 

The first major problem you will 
enounter can be with the power sup- 
ply. However, on real Apples it is rare 
for them to go wrong. If you have 
been switching on your computer 
and seeing the power light come on, 
then you have very close to a 100% 
chance that the power supply is 
operating and operating well. 

If however, you have a fake com- 
puter, then the first area to suspect is 
always the power supply. They are 
notorious for failing. The reasons for 
this are very simple. In the area in 
which they are built, the electricity 
supply (although it is a nominal 22Q 
volts) is frequently extremely sub 
standard and fluctuates around the 
189 volt mark. When these power 
supplies meet a fultblooded Aus- 
tralian current of 24Q volts the 


problem 
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The eight card slots at the rear of the 
Apple motherboard 


capacitors build up power and in 
theory the fuse built inside the power 
supply should go. Sadly, most power 
supplies from overseas do not have 
a fuse and the only way in which you 
can deal with this situation is to 
replace the power supply. 

This next section applies only to 
people who are repairing fake 
Apples. 


‘You should now have no 
wires attached to your 
machine whatsoever’ 


Turn the machine over again and 
you will see there are four screws in 
the top right-hand corner which are 
holding on the power supply. Some- 
times they are silver. Sometimes they 
are enameled, round-headed Phillips 
screws. Remove them and put them 
in a separate container. Now slip 
your hands underneath and clamp 
the power supply to the board and 
turn it back up. The power supply 
takes in the nominal 24@ volt alter- 
nating current and sends it out ina 
very Strictly controlled plus five volts 
minus five volts and plus 12 volts 
minus 12 volts and a negative signal. 
It then goes*through a plastic con- 
nector onto the mother board. Now 
before you rush out and buy another 
power supply from the dealer who 
supplied the fake Apple in the first 
place, note well! that these connec- 
tors vary widely. They may look exac- 
tly the same but very frequently they 
are not. 

To disconnect the power supply 
from the mother board squeeze the 
sides of the semitransparent white 
connector which is towards the top 
end of the power supply. Squeeze 
these two sides together and the 
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plug can be removed relatively east 
ly. Note carefully that there are pat 
terns and indentations on this plug 
to make sure that only the right male 
part fits into the correct female part. 
Now it is perfectly true you can get 
almost any type of fitting from an 
electronic parts shop that will fit into 
the part on your board. We have 
done it many times. But it is odds 
against that you will find a power 
supply with the fitting already correc- 
tly set up that will fit precisely in the 
socket that you have now remaining 
empty on your mother board. The 
odds are about four to one against. 


‘The damn things are 
rivetted together’ 


There are two ways to get around 
this. Either, when you go to the shop 
you make absolutely certain that the 
fitting attached to the power supply 
they are selling you exactly corres- 
ponds with the socket on your board. 
To do this do a very careful pencil 
drawing with measurements. If no 
such power supply is available any 
where — and that is frequently the 
case — then you will have to take a 
standard power supply and refit it 
with a new plug that matches the 
socket on your power board. This is 
not an impossible task but it is time 
consuming and it does mean that 
the lead on the power supply will of 
necessity get shorter. Because the 
plugs are so fitted that they can not 
easily be removed without cutting 
the wires. | have tried every way 
known to man to remove those wires 
in tact including melting down the 
sockets. None of them worked. In 
every case | have had to cut the wire 
as close as possible to the socket 
and start again. If you are going to 
do this it is imperative before you 
start that you make a very precise 
diagram of which colour wires go 
into which holes. The kit that you can 
buy for the plug is fitted with little 
one-way metal grippers for the end of 
each wire. In theory you do not need 
to use any solder on the ends of the 
wire. In practice | always do because 
it makes it much easier to insert the 
damn things correctly. It depends 
how manually dexterous you are. If 
you are as clumsy as | am a drop of 
solder sweated into the end of the 
wires makes life a lot easier. 


Try to dissect a fake Apple 
power supply to repair it’ 


This complication does not - 
repeat not — apply to owners of 
genuine Apples. This is because, as 
far as | have ever been able to ascer- 
tain, there is only one type of power 
connector with genuine Apple Ils 
and that connector rarely needs to 
be undone as the power supply (with 
the exception of the switch) appears 
to be relatively foolproof. 

To repeat. If you have a fake Apple 
and the power supply goes wrong 
the most probable area for problems 
is going to be matching the socket 
on the replacement power supply 
with the socket on the mother board. 
Just because they look the same on 
the outside does not mean to say 
that they are going to be the same on 
the inside. 

It is almost totally pointless to try 
to dissect a fake Apple power supply 
to repair it. Very rarely are they fitted 
with fuses. Unless you are an 
extremely competent electronic engi- 
neer you will not be able to trace 
where the fault is. And when you find 
it you will find that some of the circuit 
board has been damaged. It is 
Cheaper, quicker and better to buy a 
new supply. 

With Apple computers’ power sup- 
plies even if they go wrong you can 
not fix them. The damn things are 
rivetted together. You may think that 
this is a diabolical liberty. So do Il. 
Because within the Apple power 
supply there is a fuse and frequently 
this. fuse blows. If like me you are 
impatient with people in authority 
who rivet things together instead of 
using screws you may, as | did, drill 
out all of the rivets in order to be able 
to replace the fuse. Only do that if 
your computer is out of warranty. 
Because if you do it when your com- 
puter is in warranty then Apple will 
take the view that your warranty is 
null and void and will charge like a 
wounded bull to fix the damage. (It is 
worth cogitating at the moment on 
the mind of the engineer who 
thought of the idea of putting a fuse 
within a power supply so that the 
power supply fuse can be changed 
and then rivetting the whole power 
supply together so that the fuse can- 
not be changed. There seems to be a 
contradiction there somewhere.) a 
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Friendly 


by lan Joseph 


Computer-aided instruction is an 
idea whose time has come. But it 
must be userfriendly. This, 
however, raises the question: 


ser-friendly is a term one 
| encounters often in what is no 

doubt the start of the era of a 
computer (or its derivatives —Beltel, 
video games etc) in every home. One 
constantly hears this phrase in 
connection with one or another 
program, but what does it mean to us 
amateur programmers hopefully 
writing programs with the intention of 
others using them eventually? 

One definition | heard from an 
importer of software (he shall remain 
nameless) was: “Ahah, user-friendly. 
Does it ask you your name and all 
that?” 

While having this feature in a 
program may make the machine 
seem more friendly, less threatening 
and less mysterious, it still does not 
make it any more friendly if 
answering the above question with a 
numeric input instead of with a name 
(string input) causes the program to 
give all sorts of mysterious messages 
which a non-programmer finds as 
difficult to understand as Egyptian 
hieroglyphics. By this | refer to error 
messages of the following kind: 
?TYPE MISMATCH ERROR 
?STRING TOO LONG ERROR 
etc. 

Obviously these make sense to 
other programmers, but to the 
average person they don't mean a 
thing. 

In this article | shall attempt to 
explain what | mean by user-friendly 
and shall present a few subroutines 
which | hope will encourage you to 
go out there and write programs 
which your maiden aunt of 75 can 
use without any cries of distress. 

My personal definition of user- 
friendly is - a program that does 
these two things: it will not allow the 
user of that program to make errors 
of the sort listed above. That is, if the 
user enters data in a form unaccep- 
table to the program, the program 


REM 
REM 
REM 
REM 
REM 
REM 
REM 

HOME : 


Y/N 


1000 


S TEST?": 
1010 
1020 
1030 
2000 


HOME : END 
REM 


REM 


2010 VTAB (10): 
GET ANS 
IF ANS® < 

. > a iN fa 
RETURN 


2020 
9030 


7040 


will not crash but will tell the user 
that that particular form is not 
acceptable but another, of which an 
example is shown, is acceptable. 
Even more simply, it will not accept 
the input but will wait for the correct 
input to be given to it. For example 
see listing number one where a 
subroutine is given for trapping 
errors when a simple yes or no (Y(ES) 
or({N(O)) answer is required from the 
user. It will stop the user from 
entering extraneous information and 
possible error-causing information 
into the computer. For this example 
see listing number two, where, 
instead of asking a user which town 
is the capital of New Zealand and 
leaving it at that, the user is given a 
choice of numbered answers to 
press. 

Finally, when programming one 
should try to limit the end user's use 
of the keyboard as far as possible as, 
by so doing, one lessens the 
chances of the user causing errors. 


which user? 


ERROR 


IF ANSS = *y" 


HTAB (10): 
"ANSWER YCES) OR NCQ)" 


KKEKERKKKKKRKKKKKKKEKKES 
LISTING NQ. 1 


% 

ANSWER % 
TRAP 

BY % 
% 


IAN JOSEPH 
LRKKKKKKKKEKKKKKKERRRES 
VTAB (325 
"DO YOU WISH TO CONTINUE THI 
GOSUB 3000 


HTAB ¢€3>: PRINT 


THEN 10 


SUBROUTINE TO DETERMIN 
EA YCES) OR NCQ) ANSWER TO 
A QUESTION 


PRINT 


"Y" AND ANS < 


THEN 5020 


| suggest that you now switch on 
your computer and enter’ the 
program (Listing No 1). 

Let us look very carefully at what 
each line does in this program: 
10-70 REM statements 
1200 This line first clears the 
screen with the statement 
HOME. It then positions the 
printing in the centre of the 
screen and five lines down 
from the top by using VIAB 
and HTAB. It now prints out 
our question to which a 
Y(ES) or N(O) answer is 
required and finally, using a 
GOSUB, goes to line 5000. 
A REM statement. 
The printing is once again 
centre positioned and printed 
five lines below the original 
question. The user is here 
told to answer Y(ES) or N(O). 
Here the GET statement is 
used to input information. 
If the answer is none of the 
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SN) 
5010 


5920 
5930 
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required ones, in this case Y 
or N, then the program goes 
back to line 5029 and waits 
once again for a key to be 
pressed. 


5040 The program is told to 
RETURN and returns to the 
line after 1090, in this case 
10190. 

1910 Atthis stage having obtained 


an answer only in the form 
required we can continue 
with the program using this 
information in any way 
required. 

A few notes about the program 
and some of its quirks. | personally 
prefer the form Y(ES) or N(O) to the 
form Y/N as the former tells us more 
than the latter. There is no ambiguity 
as to what the Y and the N represent. 


| also prefer using it as a subroutine 
because it is rare that one will find 
only one question in a program 
requiring a Y(ES) or N(O) answer. | 
also prefer inputting information by 
using GET than using INPUT as the 
user Can press only one key ata time 
and, therefore, can make only one 
mistake at a time. The final point is 
the positioning of the printing in 
order to make it easier to read and 
understand. One need not necessarily 
be limited to Y(ES) or N(O) but can 
take into account other possibilities, 
ie M(AYBE) or S(QMETIMES) or 
A(LWAYS) etc. 

A few words of explanation of 
Listing No. 2: 


10-70 REM statements. 


1990 
1910 


1920- 
1950 
1960 
1970 
1080 


NN) 
5010 


HOME in order to clear the 
screen. 

VTAB and HTAB in order to 
position the printing. The 
question is now asked. 
Possible answers are given 
and they are also neatly 
printed using VTAB_ and 
HTAB. 

The correct answer is given 
(No.3). 

The number of possible 
answers Is given (foun. 

The program is sent to the 
answer subroutine at line 50 
OD. 

REM statement. 

Here the user is asked to 
choose an answer from (1) to 
AN, which is_ the _ total 
amount of possible answers. 


10 REM EX KKKKKKKKEKEKRKKKKEKREKE S040 IF VAL CANS#>) < > RT THEN 
20 REM #* LISTING NQ.2 % 2040 
30 REM x ERROR TRAP x "050 GOQSUB 6000: RETURN 
40 REM «x FOR ANSWER ¥ [20460 VTAB (20): PRINT " 
30 REM # ROUTINE FOR % 
60 REM « NUMBERS % "s REM FORTY SPACES 
70 REM #« BY ¥ 9070 VTAB (18>: HTAB (122: PRINT 
S80 REM *« IAN JOSEPH # "NO THAT IS WRONG": PRINT : HTAB 
FQ REM KES KKKKKKKREKEKERERKKKEE (7): PRINT "THE CORRECT ANSW 
1000 HOME ER IS¢"sRT3")" 
1010 VTAB (5): HTAB ¢3): PRINT " "080 GOSUB 7000 
WHAT IS THE CAPITAL OF NEW 2 [09°0 RETURN 
EALAND": PRINT 6000 REM 
1020 HTAB (35): PRINT "C19 NEW PL 6010 REM THIS CAN BE ANYTHING, 
YMOTH" : PRINT A TUNE OR A MESSAGE TO REWAR 
1030 HTAB (5): PRINT "¢2)> AUCKLA D A CORRECT ANSWER 
ND": PRINT 6020 YVTAB (20): PRINT “ 
1040 HTAB (35>: PRINT "(€3) WELLIN 
GTON" : PRINT ": REM FORTY SPACES 
1050 HTAB (5): PRINT "<4)> CHRIST 6030 VTAB (20): HTAB (12): PRINT 
CHURCH": PRINT "THAT IS CORRECT" 
1060 RT = 3 6040 GaSUB 7000 
1070 AN = 4 6050 RETURN 
1080 GOSUB 5000 7000 REM 
1090 HOME : END 7010 REM SUBROUTINE TO WAIT FOR 
2000 REM ANSWER ROUTINE ANY KEY TO BE PRESSED BEFOR 
[010 VTAB ¢20): HTAB ¢5): PRINT E CONTINUING 
"CHOOSE AN ANSLWER FROM (1) T 7O20 INVERSE : VTAB ¢€22): HTAB ¢ 
O ¢"sAN;")" 7): PRINT “PRESS ANY KEY TO 
9020 GET ANS CONTINUE": NORMAL 
“030 IF VAL ¢CANS#$) > 4 OR VAL 7030 GET WTF 
CANS? < 1 THEN 53020 7040 RETURN 
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5020 GET statement is used to 
input information. 

5930 The input is checked to see 
if it is an acceptable input 
and not outside the para- 
meters. If it is unacceptable 
the program returns to line 
5020 and waits for a key to 
be pressed. 

5049 The answer is checked to 
see if it is correct. If it is not 
correct the program goes to 
line 5969. 

5Q6Q- The correct answer is given. 

5079 

5080 The program goes to a 
subroutine at line 70@Q@ and 
Subsequently returns to the 
next question. 

5052 At this stage the program is 
sent to line 6QQ0Q. 

6292 REM statement. 

6019 REM statement. 

6020- Here the user is told that he 
is right and is given some 

6030 — sortof positive reinforcement. 

6049 The program goes to a 
subroutine at line 70@@ and 
subsequently the program 
returns to the next question. 

7099 REM statement. 

7010 REM statement. 

7020 The user is asked to press 
any key (inverse writing). 

7030 A GET statement waits for 
any key to be pressed. 

7049 The program returns whence 


it came. 


A few notes about the listing. 
Firstly, the user is not asked to type 
in the complete answer (Wellington). 
S/he is simply asked to press one 
key in order to answer (8). If required 
to type in the whole answer it is far 
too easy to make a typing mistake 
and type anything but Wellington, eg 
wellington, Wllenington etc. Sec- 
ondly, the correct answer is at some 
stage given, not leaving the user to 
flounder if he doesn’t know the 
correct answer. Thirdly, by using the 
wait routine in lines 70Q@Q-7040 (not 
to be confused with the BASIC 
command WAIT) the user can 
proceed at his/her own pace. Also, 
once again and most important, 
input is in the form of a string and 
only one ata time, thus ruling out the 
possibility of the program crashing if 
a letter is entered inadvertently. 

There is of course an alternative to 
listing two and this is listing one in a 
changed form, ie ANSWER N(EW 
PLYMOUTH) OR A(UCKLAND) OR 
WELLINGTON) OR C(HRIST- 
CHURCH). This is acceptable but, to 
my mind, not as neat as listing two. 

The program given in listing two is 
meant to be the basis of a flexible 
multiple choice test and can be 
easily expanded to as many questions 
as you require. | dm sure that, after 
having entered and tried these 
programs, you will easily get the 
hang of it. 

There obviously are thousands 


more subroutines of this kind which | 
cannot for lack of space list here. | 
am sure that there are readers who 
have written routines taking these 
problems into account and | would 
really like to see them appearing in 
these pages. ~} 0 


ak TON Fae 


Have you seen the other Gareth Powell Computer Magazines? 


Australian Business PC Report 


and 


The Australian Commodore Review 


Available from newsagents and computer stores, or by direct subscription ($18 for six issues, 
$36 for 12 issues of each magazine) from 


Gareth Powell Pty Ltd 
Top Rear, 4 Carrington Rd, 
Randwick, NSW 2031 
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EDUCATION 


Learning BASIC 


“Step by Step IT” 


ne of the best packages for 
O earning BASIC is Step by 

Step. Originally we tested the 
very first Step by Step and found it 
excellent. Now they have Step by 
Step II and it is produced by PDI. In 
a series of five lessons it takes you 
through most of the basics of BASIC 
and also introduces you to some of 
the tricks of the programmers. 

If you want to write relatively 
sophisticated programs then you 
need to go through Step by Step Il 
right to the very end. If you do, at the 
end of it you will be a BASIC 
programmer. No doubt about it. The 
course materials consist of five audio 
cassette tapes, two program diskettes 
and a 96-page work book. All of 
these three elements are essential. In 
the original program we had, the 
diskettes were missing. With them 
you find your memory is stimulated 
visually and audibly. Each of the 
three elements supports and rein- 
forces the subject of each lesson. 

In the American style they give 
you an overview of what you are 
going to be learning and then 
present you with a specific fragment 
of that larger body of information. As 
each step is mastered you will find 
yourself being able to add it to a 
previous step, so you end up with a 
complete understanding of the 
subject. Each of the five lessons Is 
broken down into two sections and 
each section is presented on a 
combination of computer displays 
produced by the program diskette 
and audio instructions from the 
cassette tapes. It works on the 
American method of multiple choice 
selection questions and at the end 
you will have learned the lesson 
through incessant repetition, none of 
it, strangely enough, being boring. 
After each mini lesson you are tested 
and then tested again to see that you 
are paying attention. We think the 
program could be slightly improved 
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by administering a _sharp_ short 
electric shock to anybody who is not 
getting the right answers, but the 
manufacturers have decided against 
this positive improvement. 

The work book’ presents a 
summary of the lesson material and 
also has practice problems and 
programs that underline, reinforce, 
expand and amplify what has been 
taught. Typically, this includes 
answering several fil-kin the blank 
type questions and writing small, five 
to ten line, programs. 

All of us who have ever worked 
with BASIC will agree that inputting 
any program is a pain but the only 
way you are going to learn is to input 
programs. And then answer questions 
concerning the program after you 
have done it. 

It is only after you have finished 
the first part of the lesson and 
completed the work book assign- 
ments that you can progress to the 
second part of the lesson, which has 
more practice problems, and then on 
to the lesson quiz. 

Each lesson quiz is given and 
scored by the computer. Like the 
work book practice problems there 
are several multiple choices. There 
are also completion questions that 
will show if you have adequately 
mastered the lesson material. By the 
time you have got to this point, you 
have learned the lesson material 
visually, verbally and from the work 
book and you have been tested in at 
least three different ways. 

If you do not score 8M percent on 
each quiz we are ashamed of you 
and we think you should sit down 
and think very carefully as to whether 
computing is going to be your bag. A 
child of 12 could walk through it. The 
publisher of this magazine managed 
to scrape through. Step by Step II is 
an excellent intermediate BASIC 
programming teaching system. It is 
considerably less expensive than 


going to a school and the system is 
designed to work with you on a one 
to-one basis. Therefore, if like the 
publisher, you are extremely slow 
and peasantlike in your learning 
processes the program will stick with 
you and follow your speed. You will 
never be embarrassed because 
there is some smartass in the class 
who is galloping ahead at three 
times the speed. 

The big disadvantage in using a 
system like Step by Step II is if you 
get stuck you do not have a teacher 
to ask. On the other hand you can 
get around this by joining any of the 
user groups, where you will be 
offered advice (quite a lot of it 
correct) until it comes out of your 
ears on any problem you care to 
mention. 

This is undoubtedly one of the 
best BASIC educational packages 
available and one we can recommend 
absolutely wholeheartedly. 0 
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Computers and education 


hat can you do with a 
VV) personal or microcomputer in 
the field of education? 

The most obvious application is to 
run educational software packages 
developed for computer aided 
learning. These range from unimag- 
inative flash card or simple question- 
and-answer type offerings to fairly 
imaginative exercises which allow 
the student to explore, discover and 
learn about the subject. Examples of 
the latter are some of the programs 
offered under the PLATO series by 
Control Data. Of Course, the suitability 
of computer aided education de 
pends to a large extent on the 
Subject matter. 

Another use for computers in 
schools is to familiarise the student 
with the operations and limitations of 
the computer. Such exercises can 
certainly foster more than a nodding 
acquaintance with common classes 
of software such as databases, word 
processing and graphics packages 
and electronic spreadsheets’ or 
integrated packages that combine 
the above features and then some. 
The student can then be _ better 
prepared to enter the job market or 
further vocational training requiring 
contact with computers. 

The third use of computers in 
education, and one that is often 
touted in advertisements to. sell 
computers, is to learn programming 
and to give Bruce or Beryl a head 
Start in tomorrows computer world. 
The question that bothers me most 
here is what should Bruce or Beryl 
compute? And which of the many 
programming languages should they 
learn? 


BASIC vs Logo 


For microcomputers, BASIC is 
one of the most readily available 
programming languages. One of its 
most attractive features is that it is 


for education 


interpretive. That is to say, the 
program is written in a human 
understandable form and the program 
instructions can be executed im- 
mediately — the computer interprets 
the instructions on the fly. For other 
languages such as FORTRAN or 
Pascal, the program _ instructions 
have to be converted (or compiled, in 
computerese) into machine code 
before execution. By eliminating this 
intermediate compilation step, there 
are considerable savings in overhead 
in computer memory and_ extra 
software, (a special program is 
needed to do the conversion to 
machine code) and in the turnaround 
time between making changes to a 
program and seeing the effects of 
the changes. This time saving more 
than offsets the loss in speed in the 
actual running of the program, 
especially in simple programs. 

It has also been claimed that 
BASIC is easy to learn — because 
there are few RESERVED WORDS or 
PRIMATIVES such as FOR... NEXT, 
also. the MAJOR _ limitations’ of 
BASIC. The very fact there are 
syntactical structures means that it is 
very easy to do simple tasks with 
BASIC but rather difficult to do 
something interesting. It is analogous 
to trying to write interesting literature 
equipped only with an early primary 
school vocabulary. 

Indeed the “simplicity’ of BASIC, 
which is often the reason given for 
promoting BASIC, arises not for the 
convenience of the user of BASIC. 
The limited expressive power of 
BASIC is really to make life easy for 
the computer designer — to make the 
process of interpreting and executing 
the Numan understandable instruc- 
tions an easier task. For instance, the 
abominable necessity to append a 
“$” to a string variable or a “%” to an 
integer variable is really to let the 
language designer know how much 
memory he needs to allocate for a 


given _ variable. For example, 
APPLESOFT requires 5 bytes of 
memory (or 5 memory location) to 
store a real variable such as 25.246 
but only 2 bytes to store an integer 
variable i.e. a whole number with no 
fractional parts. 

As a consequence, the general 
idea of learning programming, which 
is a fancy way of saying to tell the 
computer what you would like it to 
do, rapidly becomes an exercise in 
learning to wear a mental strait 
jacket. Due to the design of the 
programming language, one is 
forced to perform mental contortions 
to implement one’s ideas in a 
program. There are many who will 
truly find such chores _ intrinsically 
interesting. These computer jocks 
will no doubt find fulfilling and 
successful careers as_ software 
engineers. For the average student, 
however, such exercises are down- 
right boring. 

Many high level languages are 
available on the Apple Il and some 
are particularly suitable for special 
applications: FORTRAN for scientific 
computations, COBOL for business 
oriented programs and so on. Of 
these languages, LOGO occupies a 
very unique position, being a close 
cousin of LISP, a LISt Processing 
language used in Artificia 
Intelligence research. 

Like BASIC, LOGO is interpretive, 
that is, the compilation process 
mentioned earlier is not necessary. 
As a consequence the edit/run cycle 
is fast and easy, which is a very 
valuable asset in an educational 
environment. Furthermore, APPLE 
LOGO includes a superb full screen 
Editor which resides in memory (i.e. 
no need for time consuming disk 
accesses) and is a joy to use 
compared with the awkward Escape 


15 


ARTICLE 


sequences of APPLESOFT BASIC. 
(An Editor is a program that allows 
one to make changes to the human 
understandable instructions to the 
computer. A full screen variety is one 
which permits one to move the 
Cursor anywhere on the screen and 
to make insertions and deletions 
without tracing over with the right 
arrow and so on.) 

LOGO is a modular or procedural 
language. For instance, if you want to 
draw a star on the screen you simply 
define a PROCEDURE and call it 
DRAWSTAR, say. Whenever you 
want to draw a star simply type 
DRAWSTAR in the immediate or 
deferred execution mode as_ in 
APPLESOFT BASIC. In a way, a 
PROCEDURE is like a subroutine 
with GOSUB or DEF FN in BASIC. 
However, a LOGO PROCEDURE 
may contain many lines of code, not 
just one line as in DEF FN. Also the 
variables within one PROCEDURE 
are totally separate from variables in 
other PROCEDURESs or in the calling 
program. That is, they can have 
different values even though they 
may have the same name. It is of 
course possible to have variables to 
take on the same value throughout a 
number of PROCEDUREs. 
PROCEDUREs can also take on any 
number variables as inputs e.g. to 
specify the colour and size to be 
used by DRAWSTAR. 

Programming in LOGO becomes 
a matter of sorting your ideas into 
lots of simpler tasks Or 
PROCEDUREs. These PRO- 
CEDUREs, once defined become, 
and can be used just like any 
RESERVED words like PRINT; they 
simply become a part of LOGO’s 
vocabulary. In this manner, LOGO is 
open ended and extensible. 

In fact, it is too simplistic to think 
of LOGO as just another programming 
language. When implemented, LOGO 
turns your computer into a learning 
machine that you, the programmer, 
can teach to perform specified tasks. 
More importantly, the interaction 
between man and machine is done 
in a manner that accomodates the 
human -—_ interactive operation, 
excellent editing features, procedural 
structure, meaningful identifiers (not 
just the first two letters are significant) 
and so on. 

In an educational setting, LOGO 
provides an excellent learning and 
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ENGLISH —- 


GERMAN 


GERMAN - ENGLISH 
Combination 


communications 


PICK fA TTER AND A NUMBER. 
PRESS BGGIEION FOR WORD LIST, 
OR PRESS WllailcUM TO BEGIN. 


Plato in operation. 


exploring environment. For example, 
the teacher can define a set of 
Suitable PROCEDUREs for the 
students. They can then be set the 
task of exploring the effects of and 
interaction between these PRO- 
CEDUREs. They can use_ these 
PROCEDURES or construct new 
ones from them to solve problems. 
This way LOGO can be “taught” new 
tricks and the students learn the art 
of problem solving during this 
“teaching” process. The connection 
with Artificial Intelligence may now 
be a little clearer. 

Another feature of LOGO that 
deserves mention is the way it treats 
data. LOGO does not make any 
distinction regarding variable types. 
A given variable can at one instance 
stand for a number but later on can 
denote a character string. For 
instance, a program may require a 
series of numerical data to be 
entered from the keyboard. In BASIC 
one would have to use_ special 
characters (Esc, null or control 
characters) to signal the end of data 
entry. In LOGO one can simply “no 
more” to terminate data entry. Of 
course one can achieve the same 
effect in BASIC with a few extra lines 
of code; but then we do not want to 
conform to the wishes of the 
machine, do we? 

Apart from the usual arithmetic 
functions, LOGO has built in 
PROCEDUREs to manipulate data 
objects called WORDS and LISTS. A 


THEN 


WORD is a string of characters. A 
LIST can be thought of as a 
collection of objects. These objects 
can be WORDS or even other LISTS. 
This feature makes LOGO very 
powerful in problems involving the 
manipulation of symbols. In contrast, 
BASIC only has STRING variables 
and built in functions only operate 
on one CHARACTER at a time. It is 
of course possible to simulate the 
WORD and LIST ~ manipulating 
function in BASIC —- but it then 
becomes a case of man _ being 
subservient to the machine again. 

We hope to be able to discuss the 
LIST manipulating features of LOGO 
in a future article. 


Turtle Geometry 


One of the advantages of using 
LOGO as a learning environment is 
the availability of Turtle graphics. 

Turtle graphics is simply a set of 
commands which moves a Turtle 
around the screen. The Turtle can be 
made to move forward, backward or 
turn by specified amounts. It can 
also be made to leave behind a trail 
of ink (!) of various colours to form a 
picture. Turtle graphics thereby 
solves the problem of What to 
Compute. It is very easy to make the 
Turtle do interesting things and, as 
we shall see, Turtle graphics itself is 
a very rich source of discoveries that 
extend far beyond child play. 

You may recall the Cartesian 
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geometry you learned at school. It 
was named after the 15th century 
mathematician, Rene Descartes, who 
while watching the proverbial fly on 
the window pane, noted that it is 
possible to specify the position of 
the fly on the window by specifying 
the horizontal and vertical distances 
along the window frame relative to 
say the bottom left hand corner. Thus 
a point on the plane, (the position fly 
if you like) is determined’ by 
specifying a pair of numbers (xy) 
called the coordinates of the point. 
For example, a point located at 
3 units along the horizontal and 
5 units along the vertical is given by 
(3,5). A straight line can be fixed by 
giving the two end points. A general 
curve, however, will be specified by 
mathematical relationship between 
the coordinates of points lying on the 
curve. For example, all points (x,y) 
lying on a circle of radius R centred 
at (a,b) satisfy the formula: 
2 2 2 


(xa) +(yb) =R 


To specify a square of a given size 
with its sides parallel to the vertical 
and horizontal is very easy. However, 
to describe the same square which 
has been rotated through some 
given amount so its sides are no 
longer parallel to the vertical will 
require a knowledge of trigonometry. 


The following LOGO PROCEDURE: 
TO SQUARE :SIDE 
PENDOWN 
REPEAT 4 [FORWARD:SIDE 
RIGHT 99] 
END 


will draw the generic square. This 
LOGO PROCEDURE is self explan- 
atory to anyone who reads English. 
The Turtle is instructed to put the pen 
in the down position to draw and 
then move forward by an amount 
specified by the variable SIDE 
followed by a RIGHT turn of 90 
degrees (a right angle). This action is 
to be repeated 4 times. To draw a 
square of 190 units per side we 
simply say SQUARE 109 to LOGO. 
To draw a square that has been 
rotated by a given amount, we first 
set the initial position and heading of 
the Turtle by the appropriate amount 
and then ask LOGO to SQUARE 109. 
Turtle geometry uses a LOCAL 
(Turtle’s) view to specify a curve while 


Cartesian geometry uses a GLOBAL 
description of the curve. Technically, 
Turtle geometry uses. differential 
equations or differential geometry 
while Cartesian geometry uses 
algebraic relations for the coordinates 
of the points on a Curve. 

Turtle geometry also introduces 
the idea of the topology of a curve. A 
Square and a circle are topologically 
equivalent as one can be made from 
the other by simple stretching, and 
both are called TOPOLOGICALLY 
SIMPLE. On the other hand, a figure- 
ofeight is not topologically equiv- 
alent to a circle because the curve 
has crossed itself. These concepts 
lead to the TOTAL TURNING 
theorem for the Turtle. If the Turtle 
has traced out a topologically simple 
Curve (no crossings) then the Turtle 
has turned through exactly 369 
degrees. This is provided one 
assigns left hand turn to be positive 
and right hand turns to be negative 
or vice versa. If the Turtle had 
crossed its own path EXACTLY once 
then the Turtle has turned through @ 
or 7/20 degrees. This depends 
whether the crossing is of the figure- 
of-eight or loop the loop type. The 
analagous theorem in Cartesian 
geometry is about the sum of interior 
angles of polygons —- the interior 
angles of a triangle adds up to 180 
degrees, a quadrangle to 360 
degrees. 

The book “Turtle Geometry: the 


announce the arrival of:- 


MICRO NATIONWIDE 


Manufacturers and suppliers of quality software wish to 


SOUTH DAKOTA 
AN ECONOMIC AND MATHEMATICS SIMULATION. 


For this and other quality educational programs check 
with your local distributor or:— 


MICRO NATIONWIDE 


P.O. BOX 653, 
MONA VALE, 2103. 


/M\ ASYMBOL OF QUALITY EDUCATIONAL SOFTWARE 


Computer as a Medium for Exploring 
Mathematics” by H Abelson and 
A AdiSessa makes compulsive read- 
ing for those who would like to delve 
into the riches of Turtle geometry. Do 
you want to know, for instance, how 
to use Turtle geometry to formulate 


Einsteins Theory of General 
Relativity? 
Let me leave you with the 


following to explore: 


TO FIGURE :STEP :SINC :ANGLE 
“AINC 

PENDOWN 

FORWARD :STEP 

RIGHT :ANGLE 
FIGURE :STEP+:SINC 
ANGLE+:AINC :AINC 
END 


‘SINC 


Play with this PROCEDURE using 
the invocation: 


FIGURE 12 3 120 30 


Try first with the increments SINC 
AND AINC set to zero. Try positive 
and negative increments. Set one of 
the increments to zero. And observe 
carefully the selation between the 
inputs and the figures generated, 
and note the effects of inputs that will 
divide exactly into 99, 180, 279, 369. 
Above all, experiment. 

Happy bit grinding! O 
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Disk to tape dump utility 


by Peter Mearing 


table data-destroying disasters 
iS a necessary pasttime of all 
people involved in the running of a 
computer. This applies to almost any 
size Computer, using floppy or hard 
disks. 
| have had cause to regret not 
taking the precaution of having kept 
a copy of valuable programs ina 


Bese up disks against inevi- 


or built. The only bit of work involved 
in this system is a small optional 
circuit described below that can be 
built to control the tape recorder. 

The total cost involved in this 
backup facility is very little for the 
circuit components and_ plugs 
(excluding, of course, the tape 
recorder). All things considered, the 
backup system described here is 


best suited to long term semr- 
permanent storage of information 
such as program disks and old data 
disks whose information should be 
preserved. The system can back up 
DOS, CP/M and Pascal disks with 
equal ease because it operates as a 
data mover rather than a file mover. 
Protected disks are not amenable to 
being copied by this program. 


safe environment. Fortunately, | have, 
as yet, not had any severe losses of 
data, but sooner or later that too is 
bound to happen. 

When | first started programming 
and using the Apple, my storage of 
disks was quite small and to have 
backups of each one in current use 3 
was not too expensive. However, as 
the number of disks in active use 
Started to climb to above the 15 
mark, the sheer cost of keeping a 
backup of each was becoming 


Program listing 


TRACKS R/W 7 Track Read/Write Program. 03-Nov-1983 #0007 PAGE 1 


NEXT OBJECT FILE NAME IS TRACKS R/W.0BJ0 
ORG 1400 


REREEAAHARKARAAAA AA RARAAARAARARKEKLARERAARAAARARARKKU EH 


# TRACKS R/W: A Program to Read/Write 7 Disk Tracks. #* 
PEST CTOCSIOCCOLESL ELSI LICE LEST ELE LISELI ELE TEEPE Tre Tes te 


##% ZERO PAGE USAGE 


prohibitive, even at the cost price of PTR EQU Work Pointer 
a disk! | : OPER EQU Operation to be performed 
| decided, therefore, to look into : ERR EQu 
alternative ways of disk backup. The Set ar 
cheapest, most effective way | found : PREG —- EQU MONITER P Register Save Area 


was to use cassette tape of good : BELL EQU 
quality and a domestic tape recorder. 
A good C-99 tape doesn’t cost much 
and, being able to fit six disks onto a , BUREER. eeu ck300 
tape, this represents a minimal cost T EQU $300 
per backed up diskette — a quarter of : S EQU $301 Track and Sector counters 
the cost of using disks, or less if fate oan sind 
normal retail disks are used. If stereo 

channels on the tape recorder are Wee een oer 
used separately, then disks will fit 
onto a tape. | have always used good 
quality C9M tapes because of their 
reliability, something that cheap 
tapes definitely lack! 

All good things have a price, 
though, and this facility is no 
exception! The main price is time. It 
takes approximately 13 to 15 
minutes to back up each disk and 
the same time to retrieve it. 
Admittedly this could be shortened 
considerably, and the amount of 
Storage also improved by using * $00 EQU NULL Command 
some method other than the Monitor : * $01 EQU READ Command 
SAVE and READ routines this see So ae ea oe a 
program uses. However, that would IOBRCD DS 1 
involve a much greater cost because 
a separate interface must be bought 
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##% OTHER ADDRESSES 


Sector data buffer 


Locate RWTS Parmlist Subroutine 
RWTS Routine 


##% RWTS IOB DEFINITION 


IOB10B 
IOBSLT 
TOBDRV 
1OBVOL 
1 OBTRK 
IOBSEC 


1 I0B Type ($01) 
1 
1 
1 
1 
1 
1OBDCT 2 
2 
2 
1 


SLOT#16 

DRIVE 

VOLUME 

TRACK 

SECTOR 

Address of DCT 
Address of Buffer 
Sector Size 
Command Mode 


I OBBUF 
IOBSI2 
1O0BCMD 


#%% COMMAND MODE CODES 


Return Code 


listing continues 


System Overview 


The basic backup system consists 
of four items: the Apple computer 
with a disk drive, a tape recorder 
plugged into the Tape |/O of the 
computer, the system program anda 
small, three-component circuit that 
plugs into both the game control! 
socket and the tape recorder to 
control the tape recorder run/stop 
function. The circuit is not essential 
but it is very useful to keep 
recordings compact. 

The Apple Il Monitor SAVE and 
LOAD routines are used to write to 
and read from the tape and a 
machine language program called 
TRACKS R/W (a modified and 
extended version of the program T/S 
MOD) is used to read and write the 
disk. 

The circuit diagram of the tape 
recorder on/off controller interface is 
given in Fig 1. It takes its input from 
the game _ controller annunciator 
output AN@ and powers a relay to 
switch the tape recorder on or Off. 
Most tape recorders have some form 
of remote on/off switching mech- 
anism. If yours does not, it doesn't 
matter as the program will work just 
as well without it. The only drawback 
is that more tape will be used as the 
recorder will be left running while 
disk reads and writes take place. 
Since the disk reads and writes are 
of short duration, the extra tape 
playing time is easily accommodated 
on the tape. 

The circuit is best constructed on 
a dualintline (DIL) plug that fits 
directly into the games socket, or on 
a small piece of vero board, or a tag 
strip with wires going to plugs in the 
games socket and the recorder. The 
biggest item in the circuit is the relay, 
but | used a subminiature encap- 
sulated relay with mercury-wetted 
contacts that was about two-thirds 
the size of one of the memory 
integrated circuits in the Apple. This 
works on 5 volts and so the 5V 
supply on the games output socket 
was used to power it. In brief, Pin 1 
carries +5V, Pin 8 carries the ground 
railand Pin 15 the AN@ output. 

The transistor can be any NPU 
switching transistor of reasonable 
gain; | used a BC169C, and the 
resistor can be 9.25 or 0.125 watt 5% 
199@ ohm resistor. The relay | used 
is fairly expensive but a larger one 
can be obtained for much less. 


listing continued 


OOOE: 


OOOE: 
QOOE: 
OOOE: 
OOOE: 
OOOE: 
QOOE: 
OOOF: 
0010: 
1400: 


1400: 


1400:48 


1401:98 
1402:48 
1403:8A 
1404:48 


1405:A9 
1407:85 
1409:A9 
140B:80 
140E:A9 
1410:80 
1413:A9 
1415:8D 


1418: 


1418:20 
141B:84 
1410:85 


141F:A5 
1421 :A0 
1423:91 
1425:A5S 
1427:A0 
1429:91 
1492B:A0 
142D:A9 
142F 3:91 
1431:C8 
1432:AD 
3435:91 


1437:A5 
1439 :A0 
143B:91 


143D:A9 
143F :A0 
1441:91 


1443: 


1443:20 
1446:20 
1449 :A9 
144B:85 
1440:85 
144F:90 
1451: 


1451 :A9 
1453:20 


1456:A0 
1458:B1 
145A;:85 
145C:4C 


145F :EE 
1462:C6 
1464:10 
1466:E6 


ED 


7C 


02 


03 
03 


True Volume 
Previous slot 
Previous Drive 


This is where it all starts 


Start with Sector F 


Pointer. 
Reset Buffer. 


Do ? Tracks 


And 16 Sectors. 


Locate RWTS Parmlist 


and save pointer 


get TRACK to READ/WRITE 
and store in RWTS list 


Get Sector to Read 


Store in RWTS List 


Store Buffer pointer in List 


Get Command Mode 
and store in List 


This will allow Any Volume 


Store in List 


Reload pointers 
Off we go! 
If we exit now, we 


RWTS TO READ/WRITE THE SECTOR 


must 


Fix P reg so DOS is Happy 


Store OK code for Calling Program 
is Well, do next sector 


All 


BEEP the speaker 


Get RWTS Return Code 


Store Error Code for Call Program 


Step to next Buffer section. 


Count Down Sectors 
Next Track. 


30 #*# RETURN CODES 

32 * $00 EQU All well 
33 * $10 EQU Write Protected 
534 * $20 EQU Volume Mismatch 
SoS * $40 EQU Drive Error 
396 * $80 EQU Read Error 
$8 IOBTVL DS 1 

39 IOBPSL DS i 

60 IOBPOR ODS 1 

re | DEND 

63 *#%*% SAVE ALL REGISTERS 
65 PHA 

66 TYA 

67 PHA 

68 TXA 

69 PHA 

71 LDA #$0F 

72 STA SECTOR 
73 LDA #%20 

74 STA BUFFER 
75 LDA #%$07 

76 STA T 

77 LDA #310 

78 STA S$ 

80 #** FILL IN RWTS I0B 
82 JSR LOCIOB 
83 STY PTR 

84 STA PTR+1 
86 START LDA TRACK 
87 LDY #IOBTRK 
88 STA <PTR),Y 
89 LDA SECTOR 
90 LOY #IOBSEC 
91 STA ¢PTR),Y 
92 LOY #IOBBUF 
93. LDA #300 

94 STA <PTR),Y 
95 INY 

96 LDA BUFFER 
97 STA <(PTR),Y 
99 LDA OPER 
100 LDY #I0BCMD 
101 STA <¢(PTR),Y 
103 LDA #0 

104 LOY #IOBVOL 
105 STA (PTR),Y 
107 *%** NOW CALL 

109 JSR LOCIOB 
110 JSR RWTS 
111 LDA #0 

112 STA PREG 
113 STA ERR 

114 BCC NEXT 
116 *##% ERROR OCCURED! 
118 LDA #BELL 
119 JSR COUT 
121 LOY #I0BRCD 
122 LDA (PTR),Y 
123 STA ERR 

124 JMP EXIT 
126 NEXT INC BUFFER 
127 DEC SECTOR 
128 BPL CONT 
129 INC TRACK 


Count Down Tracks. 


listing continues 


Driving Programs 


The system program consists of 
two parts; a BASIC driving program 
(see Fig.2: Program DUMP) and a 
machine-code disk-access subroutine 
(see Fig. 3: Program TRACKS R/W). | 
will first describe the BASIC driving 
program and then fill in details on 
the machine code routine used. 

The program uses one memory 
buffer, viz a tape buffer 28672 ($7000 
) bytes long able to contain up to 
seven disk tracks ata time. 

When a disk is dumped to tape, 
each sector is read into the 
appropriate part of the tape buffer 
until seven tracks have been read. 
The tape buffer is then written to the 
tape. The process is repeated until 
the entire disk has been dumped. 

The reverse happens when retriev- 
ing disk data from the tape. Seven 
tracks are read in from the tape and 
then sector sized segments are 
written to disk until all seven tracks 
are written; this procedure being 
repeated until the entire disk has 
been retrieved. 

Seven tracks per transfer was 
chosen because the memory required 
to house all this data ($7009 or 28k 
bytes) is near the capacity of the 
normal 48k Apple and, seven can be 
divided nicely into 35 giving five full 
transfers. Whether a disk contains 35 
or 36 tracks (as may be the case in 
disks modified using the SPACE 
program), 35 tracks are transferred; 
track @ is ignored in the case of 36 
track disks as, in any case, track Q 
can contain only part of the DOS 
BOOT image and will therefore be 
present on any initialised disk used 
when retrieving the disk from tape. 

Please note that only formatted 
disks can be used for the retrieval to 
be successful; virgin or degaused 
disks will Cause write errors and 
abort the program operation. With 
the retrieval of Pascal and CP/M 
disks, please be sure to use disks 
formatted under the appropriate 
system. These disks will contain 35 
tracks in total and it is essential to 
use the 35 track mode (NOT 36 track 
mode) as track @ will contain 
valuable information on these disks. 

The machine code program used 
to read and write to the disk is the 
most efficient | have managed to 
devise so far, and uses optimum 
skewing of sectors and eliminates 
the use of intermediate buffers which 


20 


are the basis of most of the DOS 
speed-up programs available. 

The tape read/write times cannot 
really be reduced unless, as 
mentioned before, a completely 
different hardware system is used. 

Needless to say, this program can 
be improved. Disk reads could take 


listing continued 


1468:A9 
146A:85 


OF 


146C:A5 0 


146E:C9 
1470:F0 
1472:A9 
1474:20 


14977:CE 
147A:D0 


147C: 


1470:68 
147D:AA 
147E:68 
147F:A8 
1480:68 
1481:60 


1482:4C 
1485:18 


1486:A9 
1488:90 


##% SUCCESSFUL 


1F 14 


D? 
EA 


153 
154 
155 


LDA 
STA 


LDA 
CMP 
BEQ 
LDA 
JSR 


DEC 
BNE 


##% EXIT TO 


EXIT 


LDA 
BCC 


#30F 
SECTOR 


OPER 
#302 
WRITE 
#°R? 
COUT 


T 
CONT 


place to see what kind of disk is in 
the drive and parameters set up 
accordingly and stored on tape to be 
read on retrieval so all the parameters 
are correct for the specific disk 
record. An automatic disk formatting 
program could be added if the 
RWTS comes up against write errors. 


Else Start all Over. 
Reset Sector count. 


Decide on appropriate Display. 
‘Is it a WRITE? 

Yes, Branch 

No! We are READING! 


Next Track 
Continue if not yet done. 


CALLER AFTER RESTORING ALL REGISTERS 


START 


#’W’ 
DECT 


ASSEMBLY: NO ERRORS 


Restore Registers. 


Prepare to Branch after we 
Load a “’WRITE’ Symbol 
Branch back 


Symbol Table — sorted by symbol 


BELL 
DECT 
I1OBCMD 
IOBPDR 
IOBSI2 
TOBVOL 
PREG 


S 


WRITE 


BUFFER 


ERR 


IOBDCT 
1OBPSL 
IOBSLT 
LOCIOB 


PTR 


START 


10B] 0B 
TOBDRV 
ERR 

IOBS12 


TOBPSL 
T 
LOCIOB 
EXIT 
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1OBSLT 
PTR 
1OBSEC 
1OBCMD 
1OBPDR 
S 
START 
CONT 


SECTOR 
TOBVOL 
IOBDCT 
IOBRCD 
PREG 
BUFFER 
NEXT 
WRITE 


However, increased sophistication 
does imply increased complexity. 

An interesting phenomenon occurs 
should you press RESET during a 
tape READ or WRITE. Subsequent 
output to the screen may turn out to 
be garbage! To return things to 
normal simply tyoe NORMAL (less 
than sign) cr (greater than sign) while 
in APPLESOFT command mode. 

The TRACKS R/W Program works 
as follows: 

Before CALLing the program, the 
desired starting track is stored in 
memory location @. The desired 
function to be performed, 1 for a read 
and 2 for a write is stored in memory 
location 2. 

On CALLing the program, all 
registers are first saved after which a 
jump is performed to LOCIOB, a 
DOS routine which locates the 
position of the RWTS (Read Write a 
Track Sector -— a DOS _ routine) 
Parameter list. On return the para- 
meter list is filled in as regards 
desired track, sector and_ buffer 
address and RWTS is called to read 
or write the sector in question. On 
exiting RWTS a check is made to see 
whether an ERROR was encountered 
and if so, an error code is stored in 
memory location 2 for the calling 
program to do something about and 
execution aborted. 

With each read or write, the status 
display is updated with the appro- 
priate symbol. 


Conclusions 


The backup system has worked 
well on my system for more than a 
year with minimal problems and 
many revisions to improve efficiency. 
The only real drawbacks have been 
speed (lack of!) and the inability to 
verify a copy of a disk (though | have 
not had a dud tape copy yet). All my 
disks have worked well on retrieval 
from tape. 

The main advantages of operating 
this system are its cost effectiveness 
and simplicity. AS entire disks are 
backed up, it is desirable to use full 
disks, otherwise time is wasted 
backing up nothing. | hope you get 
as much use out of it as | have! 


Fig 1 Recorder Control Circuit 
TV depends on the relay used — it can be the 
Apple SV games supply if a SV relay is used. 


The DUMP program works as 
follows: 

Lines 2 to 3Q:Initialise various 
constants and CALL locations and 
Load in the TRACKS R/W routine. 
The number of tracks per disk is set 
to 35, ie the last track number is 34. 
Because | use 36-track disks, a track 
number select option is included in 
the memory should you want to use 
36-track disks. If you want 36-tracks 
by default then line 22 must be 
altered so that LT%=35 and TR%=+1. 

Lines 59 to 98: Print menu on the 
screen and allow keyboard choice of 
desired function. To quit the program, 
an extra menu choice could be put 
in or RESET must be pressed. The 
total number of tracks can be flipped 
between 35 and 36 depending on 
the known number on the disk. The 
tape recorder can also be toggled 
on or off to allow rewinding, cueing, 
etc. 

Lines 109 to 219: The Tape to 
Disk Retrieval routine. Tracks are 
read from the tape in lots of seven by 
CALLING the MONITOR tape READ 
routine after setting up the appropriate 
page 1 conditions and then written a 
blank initialised disk sector by 
sector. A status display is maintained 
to inform the user of progress. If tape 
read errors then ERR message will 
appear in the status display and the 


to Tape Recorder 
Ne ‘Remote’ Socket 
bY 


4———_________b 


BC 169C or equivalent 


retrieval process should be stopped 
and retried. The tape recorder is 
switched from run to stop and vice 
versa by accessing the appropriate 
memory locations controlling the 
ANQ@ Output on the games I/O socket 
if the tape control interface is 
installed. A short delay is instituted in 
line 125 to allow the recorder to 
come up to speed before reading is 
commenced. 

Lines 309 to 419: The Disk-to- 
Tape Dump routine. Tracks are read 
in lots of seven, sector by sector, into 
the tape buffer memory area and 
written to the tape en masse using 
the MONITOR tape SAVE routine. 
Both the SAVE and READ routines 
require the start and end addresses 
POKEd into memory at locations $3C 
to $3F. The MOVE routine requires 
the origin start and end addresses at 
locations $3C to $3F, and the 
destination start address in locations 
$40 and 41. 

Lines 450 to 490: Set up the 
status display. It is individualised for 
either a 35 or 36 track retrieval/ 
dump. 

Line 50@: Gives a pause with the 
tape running to provide a gap on the 
tape between disk records. 

Line 709: A simple error handling 
routine to cope with errors encount 
ered by TRACKS R/W. O 
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GAME REVIEW 


Farming in “South Dakota” 


and mathematics simulation 

game developed by Educational 
Activities Inc and distributed by 
Micro Nationwide. To use _ this 
program you will need an Apple Il, 
one disk drive and 48K of RAM. 

My first impressions of the 
program were of the packaging, 
which is nothing to write home about. 
Have you ever seen those cheap 
shirts that come in plastic bags with 
a coat hanger type seal at the top? 
Great if you have a nice container to 
Store your disks in, but not very 
thoughtful for those who rely on 
receiving their disks in a nice hard 
box, which keeps them safe when 
not in use. The other complaint is in 
the documentation. Not that it isn't 
well written, it is. Its just that it is 
supplied loose with no_ binder, 
although the makers have thought 
fully punched holes so it can be 
inserted in the binder of your choice. 

Included in the documentation 
are various tables you can photostat 
and use to keep a record of the 
Statistics of the game as you 
progress. This is essential if you are 
to use the program as it was 
intended — as an educational tool. 

The object of the game is to runa 
farm in South Dakota for a period of 
ten years (game turns). Sounds 
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S ana Dakota is an economic 


Reviewed by Gary Williams 
Distributed by Micro Nationwide 


easy? Think again. On my first 
attempt | was bankrupt within three 
years. It definitely pays to utilise the 
tables supplied to keep track of 
money in and out, etc. Although | 
found it more fun to simply waffle 
through using intuition. 


‘Keep a record of the 
statistics of the game as 
you progress’ 


When you finally make it through 
the ten years you are given your 
initial assets as Compared to your 
final assets. Unfortunately, you will 
be in for a rude shock if you haven't 
kept a record of everything as 
Suggested in the manual. The first 
time | managed to complete the ten 
year term | ended up with half the 
assets | started with, which is most 
disconcerting after spending all 
those years working my fingers to the 
keyboard. 

Each year (game turn) you must 
decide which grain to sow from a 
choice of five (barley, wheat, oats, rye 
and corn). Then you must purchase 
enough seed to sow your acreage. 
You initially have 159 acres and $50 
Q to build on. Depending on how 
many acres you wish to sow, you 
may need to hire extra help (the cost 
of which increases each year). As 
well, a large amount of cash is 
subtracted from your kitty to feed 
and clothe you and your family over 
the growing and winter seasons. 

Unfortunately you will find that 
your $502 capital investment is 
nowhere near enough to cover the 
cost of your first year as a farmer. 
And so enters your smiling bank 
manager. YOu can borrow as much 
as you like up to $9,902 but, as with 
all banks, you will have to pay 
Interest, at 12% per annum. 

If, like me, you have a natural 
aversion for banks, you can always 
sell some of your land. This can be a 
good thing as the market price of 
land varies between $199 and $699. 


So if your green finger is looking a 
bit brown you may be able to make 
up the deficit in real estate 
speculation. 

A nice touch is the musical 
interlude which plays during the 
growing period. This is the time you 
Start pruning your finger nails down 
to the cuticles hoping you have 
made the right decision as to the 
crop chosen. 

After the growing period is over 
you are told the new selling price of 
the five grains, which are affected by 
a variety of things. These range from 
floods and droughts to pesticide 
scares and the economic climate in 
the USSR. Your grains are auto 
matically sold and the profits, less 
tax, are added to your kitty. Then you 
must pay back half of your loan, plus 
interest, to the bank. Like all banks 
they can get very stroppy if you 
haven't the funds to pay them back. 

Another nice touch is the fact that 
you can purchase things like 
chickens, cows, tractors and combine 
harvesters (if you can scrape up the 
$20,000) to help ease your burden. 
The chickens and cows are relatively 
inexpensive and save you a bit when 
the time comes to buy food for your 
family. The tractor and combine 
harvester seem very expensive at 
$13,009 and $20,000, but they take 
the place of numerous farm hands 
you would normally have to hire 
twice each year, when sowing and 


harvesting. Also, their value is 
included in your assets which 
unfortunately depreciate in value 


each year. If you have taken a loan to 
buy your farm machinery (which I’m 
certain you would have done) you 
may find yourself in some strife if 
your crops fail. If this is the case, the 
bank may very well take away your 
tractor and/or combine to meet your 
commitment. 

The graphics left me a bit cold, 
and are restricted to a static picture 
of your farmhouse in three different 
situations. The first its of the 
farmhouse in summer, the second is 
the same but in winter and the third 


GAME REVIEW 


‘On my first attempt I was 
bankrupt within three 
years’ 


is one you will not want to see (a 
derelict farm house with a foreclosure 
sign on it). As well, there is graphic 
representation of the five grains on 
the left of the screen when in the 
playing mode. 

As an educational too! South 
Dakota would be invaluable to those 
people learning farm management, 
but as a pure game it can be very 
frustrating. A feature of the program 
that makes it appealing as an 
educational tool and annoying for 
the game playing purists is the 
“oress space bar to continue” 
feature. This is to allow time to keep 
your records up to date after each 
transaction. | would like to see the 
program incorporating a choice of 
whether to include this feature or not. 

South Dakota costs $59.09 and 
I'm told there will be an Australian 
version for sale in the not too distant 
future. The ability to save a game at 
any stage would be an advantage, 
and |’'m told the distributors intend to 
do something about that, too. This 
means that South Dakota, as a farm 
management game, could be used 
as an “if-then” type set-up. Allowing 
the users to say for example “OK, 
here’s where we stand now, how 
about we try this and see what 
happens” and if that proved disas- 
trous they could reload where they 
started from and give something else 
a try. 

So there you have it, South Dakota 
is a brilliant educational tool that 
doubles as a down to earth game 
(excuse the pun). It can be played 
with little Knowledge of farming and 


still thoroughly enjoyed. O 
Ease of use lai 
Graphics <s 
Sound me 
Value for money. 

as a game only iia 

educational as 
Sustained interest ae 


Note: the above ratings are out of a 
possible five stars. 


TIPS AND TECHNIQUES 


by Peter Meiring 


hen | first bought an Apple I! 
V\) about two years ago, | had 

visions of storing vast amounts 
of information on disk with near 
instant recall, correlation and com- 
putation of all of it. Alas, | found that 
Standard DOS 3. is restricted to 
only 496 sectors of disk storage 
space (124k), less any housekeeping 
sectors that are necessary with all 
files stored. Undaunted, | decided to 
investigate methods of increasing 
storage Space on disks and came up 
with three basic methods, namely: 
1. Pre-storage packing of information 
and more advanced database 
management. 
2. Deleting the diskette DOS (Disk 
Operating System) image and using 
the space it occupied or using 
sectors unused by the DOS if a DOS 
image is required to let the disk bea 
BOOT disk. The same applies to the 
Space occupied by the catalog on 
track 17 ($11) if one only intends to 
use a Strictly limited number of files 
on the disk. 
3. Using Track 35 (normally not 
initialised by INIT). 

In this article | shall discuss the 
latter two methods (prestorage 
packing and advanced database 
management are enough for another 
complete article!). First | will discuss 
some of the relevant details pertaining 
to the Apple DOS and then give 
some sample programs to illustrate 
implementation of the ideas. Using 
both methods, up to 544 (136k) 
sectors are usable as opposed to 
496 (124k) on a normal DOS disk. If 
a disk is used for a maximum of 7 
data files, a further 14 sectors can be 
used by freeing them in Track 1/7, 
giving a total of 599 (139.5k) sectors 
usable, 62 (15.5k) sectors more than 
normal. This corresponds to a 12.5% 
increase In space. 

Most numbers and values are 
given in decimal and hexadecimal; 
the latter numbers are preceded by 
the symbol $. 


More disk storage 
under DOS 3.s 


Using DOS Sectors for 
Storage 


The DOS organises its disks by 
formatting them to have 35 tracks (Q- 
34 or $9-$22) of 16 sectors each. Of 
these, Tracks Q, 1 and 2 are used by 
the DOS to store an image of itself to 
copy into the Apple’s memory during 
the BOOT process and Track 1/7 
($11) is used to store the CATALOG 
of the disk as well as its Volume 
Table of Contents (VTOC). 

When the DOS is storing § infor- 
mation on a disk and has filled up 
the sector it is Currently writing to, it 
jumps to a routine that reads the 
VTOC. It examines this sector and 
finds which sectors are still unoc- 
Cupied so it may set its pointers to 
write the next lot of information to the 
next unoccupied sector. This sector 
is then marked in the VTOC as used 
and is then protected from being 
overwritten by subsequent information. 

The sections of the VTOC res- 
ponsible for this housekeeping are 
the track bit maps located from byte 
number $38 to $FF. Each of these bit 
maps are four bytes long, giving, in 
theory, enough space in the VIOC 
for 5@ tracks but only 35 are used 
normally. Of the four bytes, only two 
(16 bits) are necessary to map any 
given track as each track contains 
16 sectors. Each of the bits in the 
two used bytes corresponds to one 
sector in the track; if a bit is set to a 
‘{’ then that sector is not currently 
used by any stored program; 
otherwise, if set to ‘Q’, it is in use. 

The only protection for the sectors 
used by any program, ar the DOS for 
that matter, therefore lies in the exact 
status of the VTOC situated on Track 
17, Sector Q. If the VTOC is damaged 
in any way, no program on the disk 
can be considered as safe unless 
the disk is write protected or the 
VTOC is restored to its former glory! 
Similarly, if the bit maps of Tracks 1 & 
2 are set to 11111171 11111111 00 
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TIPS AND TECHNIQUES 


Program listing 4 


DDOKDD DPOOOOOE (SFF SFF $OP 
$2), then the DOS will consider 
them vacant and use them when 
needed. The only drawback is a disk 
so modified will not be suitable for 
BOOTing the Apple, but this is no aa NEXT OBJECT FILE NAME IS FORMAT . CBJO 

real price to pay for the extra sectors ep : ones eres 

of storage space (up to 12.5k or TS RERKERE EERE EKER EHR E RE RHEE RHEE EERE ERE EKER ER EERE EEE EH 
12,800 bytes) since data disks do 1300: 6 * FORMAT : A Program to INIT any Track on a diskette * 
not, in general, need Q copy of the ? KEE KFKEKEKREFREKFERKKKKHKHEREKE SSE EBEKREKKEREREKREKRKEKRERKRKKHKRKEK 


FORMAT Track Formatting Program 05-05-1783 #00018 PAGE 1 


DOS on board. 1300: 9 **¥*% ZERO PAGE USAGE 
Track 9, Sector @ cannot, unfor- ee: re sone jp as 
tunately, be used in the same way 0000: 12 TRACK EQU #0 Desired Track. 
because of the way the DOS works. a os Meee a #1 a 
: : + 0 U £2 lesire peratian. 
What happens can be explained 002D: S SECENEE EG” Lon 
as follows: — | OO3E: 16 AA EGU #36 
The basic structure of a file on aaa aes ese 
disk consists of three parts: 004s: 17 SYNCNT EGU #45 Syne count used by DSKF2 
1. Catalog entry consisting of a 0048: 20 PREG EQU #48 MONITER P Register Save Area 
Track/Sector list Pointer, File type es APSREES «cea eee Renn aes 
code, File name and a sector count. 1300: 2% ¥x* OTHER ADDRESSES 
2. Track/Sector list, being a list of 3 
: : : : NSES: 23 LOCIOB EGU #3E3 Locate RWTS Parmlist Subroutine 
track/sector paleo which the file O3D7: _ 2s RWTS EQU #39 RWTS Routine ~ 
data resides on disk. OS78: 2? RTRYCNT EGU #578 Retry count for DSKFZ 
3. Data pointed to by 2. above. a zs ial aay eee. Primary Sector Buffer 
. . “OQ s zy N 2 26C Secondary Sector Buffer 
When the DOS is asked to retrieve BSDC: 20 READIé EGU #£BSDC Read Data Field Routine 
a file, it first looks in the catalog B944: 31 RDADRI6 EGU #£B944 Read Address Field Routine 
(Track 17, Sectors 1 to 15- starting BFUD: 32 DSKF2 EQU #BFO0D Format Une Track Routine 
, ae FOED: 33 COUT EQU #FDED T 
in Sector 15) to find the file in me . — 
question and retrieves the contents 1300: 35 *** RWTS 108 DEFINITION 
of the Catalog entry. Using the Track/ : : 
cood: 37 DSECT 
Sector List Pointer, it then accesses ooo: 38 IOB10B bs 1 108 Type (#01) 
the Track/Sector list and retrieves the oe 39 IOBSLT DS 1 SLOT #16 
; ; ; o00z: 40 IOBDRV DS 1 DRIVE 
first Data Track/Sector pointer which ange: AES TOBUGE. (bee <i SOL GE 
It uses to retrieve data. Upon 0004: 42 IOBTRK DS 1 TRACK 
complete retrieval of that sector, it San pe cee = : SECTOR 
: . : s ; Address of DCT 
jumps back to the Track/Sector list, 0008: 45 IOBBUF DS 2 Address of Buffer 
gets the next pointer, retrieves the 000A: 46 DS 2 
data and so on until it retrieves a ane. . eee =e yeah ala 
. H ; eturn ode 
track/sector pair both equal to zero, OO0E: 49 IOBTVL DS 1 True Volume 
signalling the end of the Track/ GOOF: SO IOBPSL DS 1 Previous slot 
Sector list. 0010; Si IGBPDR OS 1 Previous Drive 
1300: 52 DEND 


It can be seen that, should one try 
to use track Q, sector @ in the track/ 


sector list, the DOS will promptly 1300) Benen aia myer wagers 

abort retrieval of information. This is 1300348 S35 PHA 

due to DOS being under the false 1301398 59 TYA 

impression that the last sector of eae me se 

information had already been re 1304:48 62 PHEs 

trieved and the file was at an end! 

Hence, no user access to track Q, 1305: 44 *¥# USE RWTS TO FPOSITIGN THE ARM TO DESIRED TRACK 

sector @! Hence, theoretically, 15 1305:20 ES 03 56 JSR LOCIOB Locate RWTS Parmlist 

sectors are available on track @. In 120&:84 03 67 STY PTR and save pointer 

fact, the Apple DOS is a little lazy oe deve 39 ope ae get TRACK to READ/WRITE 

and does not bother checking both 1Z0E:A0 04 70 LOY #IOBTRK and store in RWTS list 

track and sector pointers; making do eee a ao La a ere 

with just the Track pointer. If it ae a coy WIOEEME: ancrstore ie 1 het 

encounters a zero track pointer then La1é:71 03 74 STA CPTR),¥ : | 

it assumes it has reached the end of eae bp iby wIceOL 

the file! Hence track @ is best left 1Sic:F1 OF 7? ST& (PTR, 

alone. 131E:20 E3 O3 78 Jsk LOCIOB Reload pointer to parms 
In summary, all one has to do to eee Ge oe ary coae Wee ee ees 
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TIPS AND TECHNIQUES 


1327 G2 x** ESTABLISH ENVIRONMENT FOR DISKF2 ROUTINE 
1327:A5 o0 a4 LDA Thee sera Seee pe ee use the DOS Sectors for user 
: 35 STA ass Track toa SKF 2 . . 
cea = Te McC: “Beas uate programs is to modify the VTOC to 
aeedes al a7 STA VOL ee aes indicate them to be available for use. 
LaZFsAy AA 8S ssh nes Store constant for ZERO PAGE TIMING The same applies to the catalog 
331:85 3€ 89 STA A 
as ae ce 0 LDA ##28 Start with 40 syncs sectors on track 17 ($11). 
1335:85 45 91 ST& SYNCNT One interesting point hinted at 
1927160 3s ee nee pees above is that DOS does not use all 
1339:A9 0 3 
133B:99 FF BB 4 ZNBUF2 STA NBUFZ2-1,Y ZERO Secondary Buffer the sectors in Tracks @, 1 and 2. In 
133E:88 95 DEY fact, most of Track 2 is unused; only 
133F:D0 FA 96 BNE ZNBUF2 
1341:99 00 BB 97 ZNBUF1 STA NBUFI,Y and Primary Buffer oe peor oe ee 
1344:88 98 DEY ( 
1245:D0 FA v9 an eNeuet Se ene 2816 bytes are available on Track 2 
° IS & ‘ ; : 
peas i aa LDA #£08 in case of ERROR without damaging the DOS at all and 
134C:B0 19 102 BCS ENDERR ERROR without affecting the BOOTability of a 
134 105 ees FEab SECTOR G OF NEW TRACK TO WERIF’ FORMATTING ane This : ae if one cay : 
urnkey system with program dis 
ade 0 eo ED eee bee see ipa ah a and lookup data files in drive 1 and 
S50:80 7& 5 as STH RTRTC allowing 4 “les ; : 
oon se roe neon CER data disks (without the DOS on 
1254:CE Pa 0S 110 DEC RTRYCNT Count the Retries! board) in other drives. 
1257:F0 OF 111 BEG ENDERF 
1357¥:20 49 BY 112 JSR ROADRI < READ an Address Field . 
135C:80 FS 115 BCS  NOGCOD a os Using Track 35 for 
LSSE:as 20 114 LOA SECFND T= this Sector ZERO? 
tzsc:00 Fi! 115 BNE NoOGOUD No, try again Storage 
136Z:20 DC BB 116 JSR READIS yes, READ Data Field . . . 
1zes:50 OF 117 BCC DONETRK All is well | first hit on the idea of using Track 
it4F;3;Aa OD 118 ENDERF LOY #IOCBRCD Create Return Code environment 35 ($23) when | noticed some 
136791 08 11¢ STA «PTROVY 
protected disks use it to store 
1366 1Z1 #2 ERROR OCCURED! | information. Using Track 35 provides 
136B:a9 a7 123 LOA BELL BEEP the speaker an extra 16 sectors or 4,096 bytes 
1360:20 ED FD 124 JSR COUT (4k) to the user. Most Apple disk 
ea me or ee ey eee ee drives are quite capable of accessing 
3723 < ee - C ng 3 “4 S a “Ti Wat) : 
1274:85 02 1Z7 ST4 CREP Error Code for call Program Track 35; only the very early ones 
(pre DOS 3.2) have a little difficulty 
1376 were SEAT TO Geeeen sometimes. | have used Track 35 on 
1376:BD 8S CO 131 DONETRK LOA #COUS&.x Turn OFF the Drive most of my disks for almost a year 
1379:A9 00 132 LDA #200 : | | now and have experienced no 
137B:85 48 133 STA PREG Clear P register for DUS problems with drive errors or 
137D 135 *** Restore all Registers alignment. ree 
ae ae cae ne To use an uninitialised track, two 
¢ 26 ‘ . : 
137E:AA 138 TAX things must be done. First the track 
137F 68 139 PLA must be initialised, that is, it must be 
1390 :A& 140 ad formatted by writing to it an image of 
1381:68 141 PLA : 
gee - eG 142 RTS a blank track so the DOS can read it 


x*#* SUCCESSFUL 


ASSEMBLY: NO ERRORS 


should it have to and, second, the 
VTOC must be amended to inform 


SYMBOL TABLE SORTED BY SYMBOL 05-05-1983 #00018 FAGE 4 the DOS that those tracks are 
available for use. 
3E AA ? BELL FDED COUT 1376 DONETRK 
BFOD DSKF2 1367 ENDERR ? 08 IOBBUF OC IOBCMD There are basically two ways of 
> O06 IOBOCT > O02 IOBDRYV * OO IOBIOB 2 i topes getting onto Track 35: 
2 OF IOBPSL 0D IOBRCD ? OS IOBSEC ’ ; ; 
04 IOBTRK 2 O€ IOBTUL 03 10BVOL O3E3 LOCIOB 1. Modify the DOS so it will 
B00 NBUF1 BCOO NBUF2 1353 NOGOOD 02 OPER automatically initialise Track 35 
48 PREG Oe ete ees eee eee thedae during INIT and update the VTOC 
0578 RTRYCNT 03D9 RWTS S ; 
00° TRACK 44 TRK 01 VOLUME 41 VOL accordingly. The disadvantages of 
1341 ZNBUF1 1336 ZNBUFZ SYMBOL TABLE SORTED BY ADDRESS doing this is that only blank disks 
can be initialised without losing data 
SSH res MOVES eee and so this method cannot be used 
2 00 108108 00 TRACK ? 01 IOBSLT 01 VOLUME on disks containing data without 
? 02 TOBDRV 02 OPER 03 PTR sf TGEEE going through the laborious process 
04 IOBTRK ? 0S IOBSEC 2? 06 1OBDCT 2 0 ; 
0c IOBCMD 0b IOBRCD 2? OE IOBTUL ? OF IOBPSL of recopying data from disk to disk. 
> 10 IOBPDR 20 SECFND 3E AA 41 VOL 2. The other way is to write a program 
44 TRK Pear ee weve il eee geet saree that selectively initialises Track 35 
0309 RWTS 3 : 
1341 ZNBUFI 1353 NOGOOD 1367 ENDERR 1376 DONETRK and then updates the VTOC accor 
B38DC READI6 B944 RDADRI6 BROO NBUFI BCOO NBUF2 dingly. This will preserve any data on 
BFOD DSKF2Z FDED COUT 


the disk. 
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TIPS AND TECHNIQUES 


Accessing VTOC 


All the discussions above refer to 
modifying the VIOC. To do this one 
must be able to read the existing 
VTOC from the disk in question, 
modify it and then write it back again. 
Listing 1 is a small program, 86 bytes 
long, called simply T/S MOD that 
does just that, by setting up the 
appropriate parameters for the DOS 
and then calling RWTS (Read Write 
Track Sector - a DOS routine). It is 
written in machine code and takes its 
commands from three page 1 
memory locations, namely $00, $01 
and $22: 
$02:This is set to 1 for a disk read 
and to 2 for a disk write. 
$01:This is set to the desired sector 
number ($Q-$ F). 
$0Q:This is set to the desired track 
number ($0-$23). 

On entry to the program. all 
registers are saved, after which a 
jump is made to the page 3 memory 
location LOCIOB which contains a 
jump instruction to the DOS routine 
which locates the RWTS IOB (Input/ 
Output Control Block). The reason for 
this step is to make the program 
memory size independent as it will 
locate the IOB no matter where it is. 

The next section of the program 
proceeds to set up the IOB with the 
relevant Track and Sector data 
before proceeding to the final 
section where the DOS RWITS is 
called to read or write the sector to or 
from memory. If an error occurs then 
an error code is stored in memory 
location $92 for the calling program 
to access and do something about. 
Before exiting, all registers are 
restored to their pre-entry states. 


Initialising Track 35 


Listing 2 is a delightfully short 
BASIC program called DOS 35 that 
will modify the DOS in memory so 
when a new disk is initialised using 
the DOS INIT function it will 
automatically be formatted to have 
35 tracks. The memory locations 
apply to a 48K Apple, only. For a 32k 
Apple, subtract 16384; for a 16k 
Apple, subtract 32768 from the 
values given. Should the SPACE 
program below (qv) be used ona 
disk initialised with this DOS, no 
harm will come to the contents of 
track 35. The functions of releasing 
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Program listing 2 DOS 305 


10 REM 


100 POKE 
110 POKE 


200 HOME 


2itt VTAB i 


999 NEA 


SS NEXT QBJECT FILE NAME 15 T/S MOD. OBJO 
3 


0003: 
M002: 
DOO1: 
mao0c: 
OO01s: 
nagzs: 
0048: 
1037: 


1400; 


1770: 
OSES: 
U3DS: 
FDED: 


1400: 


UdcOac: 
acoa:; 
OOO1: 
0002: 
H003: 
0004; 
DQoOO0S: 
nadés 
u00ds: 
DOO0A: 
DO0C: 


Oag00: 


oaud: 
O00D: 
OoO0D: 
OOo0D: 
noud: 


QOUE s 


NOUEs 
QOdE: 
UCGUOE: 
OOUE: 
OcOE: 
OCUE: 
OaOF : 
noid: 


1400: 


ae] 


iahen 


that 


by P 


2) *##e® OTHER ADDRESSES 


Woot wo ob a oo os Wh 
COANOaMbwON aw 


3, 144 
4, 36 
PRINT 


PTR 
OPER 
SECTOR 
TRACK 
READ 
WRITE 
PREG 
BELL 


BUFFER 
LOCI OE 
RWTS 
COUT 


ee RWTS IOB DEFINITION 


IOBIUE 
IOBSLT 
1OBDRYV 
TOBVOL 
IOBTRK 
IOBSEC 
TOBOCT 
1OBBUF 
1OeSI2Z 
1QBCMD 


x*%% COMMAND MOCE CODES 


#*%*® ZERC 


* £00 EQU 


" Plea 


: & Basic Program to modity a NORMAL DOS 


it will create 36 track Diekettes 


the INIT command is used. 


ieter Meircng &.5c.¢Hons) ME Chg. 


» Location #4EBS set to #70. 
: Location #BEFE set to #24. 


se Write ar toad your HELLO’ 


program and INIT a BLANK diskette 
ta obtain a 24 track diskette." 


Program listing 3 T/S MOD Track and Sector Accessing Program 


aRG 


HEKEERERKEEEEEKEEERELEEREREERERELEREEEEEEEEEEREREEREEESE 
* T/3 MOO: A Program to read/write any sector on. disk.* 
HEEEERELEEENEEELEEEEEEEREREREREREEEEERERERELEEEEREREEER 


EQU 
EQU 
EQU 
EQU 
Eu 
EQu 
Eau 
EQu 


EQu 
EQU 
EQU 
EQU 


DSE 
OS 
DS 
DS 
DS 
DS 
DS 
DS 
DS 
DS 
DS 


* £01 EQUI 


® £02 


EQU 


x £094 EQU 


IOBRCO 


eee RETURN 


® £00 
* £10 
= £20 
* £40 
* £90 


LOBTUL 
TOBPSL 
TORPDR 


DS 


EQu 
Eau 
EQu 
Eau 
EQu 


DS 
DS 
OS 


PAGE USAGE 


NULL Command 


WRITE Command 


DEND 


#1900 


#3 Work Pointer 

#2 Operation ta be pertormed 

#1 

#0 

1 Fead operatian 

2 Weite oaperatian 

2495 MONITER F Register Save Area 
#57 


600d Sector data buffer 

#3E3 Locate RWTS Parmliset Subroutine 
#3D7 RWTS Routine 

#FOCED COUT 


CT 
1 IQB Type cC#015 
1 SLOT#14 
i DRIVE 
1 VOLUME 
1 TRACK 
1 SECTOR 
z Address af DCT 
Fa Address af Buffer 
zZ Sector Size 
| Command Mode 


READ Command 


FORMAT Command 
1 Return Code 


CODES 


All well 

Write Pratected 
Valume Mismatch 
Drive Error 
Read Error. 


1 True Volume 
1 Freviaqus slat 
i Frevicus Orive 


TIPS AND TECHNIQUES 


14u0:48 48 PHA 
1901:768 é9 TTA 
1902:4¢ 70 PHA 
1402:5A ? TXA DOS and catalog sectors are, 
1404346 72 PHA needless to say, not available in this 
1405: 74 «xx FILL IN RWTS 108 program! For the person who wants 


least hassle and is satisfied with only 


1905:20 E3 03 76 JSR LOCIOB Locate RWTS Parmlist i j 
1908:849 03 77 STY PTR and save pointer 4k more aa this REGIA ts best. 
140A:85 04 78 STA PTR+1 Listing is a short machine 
acters = ase at any . language program, 131 bytes long, 
: Get TRACK to READ/WRITE i 
190E:A0 04 81 LDY #IOBTRK and store in RWTS list called FORMAT that will format any 
1410:91 03 82 STA (PTR),Y track on the disk. It uses the same 
141Z:A5 O1 83 LDA SECTOR Get Sector to Read page 1 memory locations as T/S 
i eae as Sos. nae Soo eee MOD above for user control. 
Briefly, it works as follows: 
ae oie a a aah aes Set it Back to 0 On entry, all registers are saved on 
” the Program Stack (Page 1). As with 
141C:A0 05 90 SOK LDY #IO0BSEC | T/S MOD a jump is made to LOCRPL 
eee a Ne teste eer er nae ae and the RWTS IOB is set up. The 
1422:A9 70 93 LDA #>BUFFER Store Buffer pointer in List DOS RWTS is then called with a null 
1424:91 03 94 STA (PTR) ,Y command to position the disk drive 
Pare a Tae Savane een head over the appropriate track. 
1429:91 03 9? STA (PTR),Y Parameters are then set up for the 
14Z6:AS 02 101 LOA OPER Get Command Mode DOS Disk Format routine (DISKF2) 
eevee ah oc 102 LD’ #TOBLMD and store in List which is then called to write a 
taetgee ne a ee formatted track. After formatting, a 
read of the track is performed to test 
igBisary OO 106 Loe #0 any Votume will do th t k f . t es ld 
1423:A0 02 107 Loy #1 0BVOL € track Tor integrity. onould an error 
1435:91 03 103 STA (PTR) ,Y occur, an error code is generated 
437 110 #*#* NOW CAtlL RWTS TU RFEAD/WRITE THE SECTOR and stored lor the calling Progiam to 
nna gee sort out. Before returning control to 
1487:20 EF US 112 JSR LOCIOE Reload pointers the calling program, all registers are 
19364:20 DF U3 113 JSR RWTS j 
1930:An7 OC 114 LDA #0 again restored. ; ‘ 
143F:85 48 115 STA PREG Fix P reg so DOS is Happy It should be noted this program is 
1441:85 a2 114 STA OFER Store OK code for Calling Frogram memory dependant, and should it be 
eee MY Boge erie pe weer written for systems of less than 48k 
1445 119 #*#8 ERROR OCCURED! : RAM, the values of NBUF1, NBUF2, 
ue : a a. gua, eee ; READ16, RDADR16 and DISKF2 
S a7 : 1@ speaker . 
1a47:20 ED FD 122 JSR COUT should be amended to suit the 
amount of memory available. 
1944:A0 UD 124 LOY #IUBRCD 
194C;:61 us 1235 LDA <‘(FTR),Y Get RWTS Return Code a = 
144E:85 02 126 STa OPER Store Error Cade for Call Program Putting it all together 
1450 128 *** EXIT Ta CALLER AFTER RESTORING ALL REGISTERS The machine language programs 
Si oe | use a section of memory from 4864 
1950:48 130 EXIT PLA 
1451:AA 131 Tax to 6255 ($1300 to $186F). FORMAT 
eee = tes resides in memory between locations 
42S SA 
eae a3 nes 4864 and 5003 ($1309 to $1394). T/ 
1455:60 135 RTS S MOD resides between memory 


locations 512@ and 5196 ($149@ and 
$144B). These memory locations 
were chosen arbitrarily so T/S MOD 
could reside just above FORMAT, 


xex SUCCESSFUL ASSEMBLY: NO ERRORS 


SYMBOL TABLE SORTED BY SYMBOL GO5-G5-1983 #0001¥% PAGE 4 


@7 BELL 1770 BUFFER FDED COUT 1450 EXIT which is just above a BASIC 

a3 1OBBUF OC TOBCMD ? 06 TOBDCT 7 02 TOBDRY program written to access them. 600 
? 00 IOBI08 ? 10 IGBPDR 7 OF IOBFSL Ob IOBRCD : 

05 1OBSsEC > Ga 10BSI2Z 7 @1 IQBSLT G4 IOBTRK Q was just a convenient decimal 
? GE TOBTUL 03 TOBVOL OSE3 LOCIOB U2 OPER number at which to locate the buffer 

43 PREG U3 PTR * O1 READ 0307 RWTS ili l 

G1 SECTOR 1410 SOK a0 TRACK > 2 WRITE cP eee rarerataar Scan oc 
SYMBOL TABLE SORTED BY ADDRESS OS-05-1983 #00019 PAGE 5 buffer. 

; ) : A sample BASIC driving program 

00 TRACK > gO 10BI1cGR ? G1 READ ? 1 IGBSLT 

1 SECTOR U2 OPER > O02 LOBDRY Be ie WEIGE called SPACE, using both T/S MOD 

a3 03 IOBVOL 04 LOBTRK oS IOBSEC and FORMAT Is given in Listing 4. 
2 06 IOBDCT _ 08 TOBBUF OA 10BSIZ ac 1OBCMD It works as ae 

0D IOBRCD 2? GE IOBTVL > OF 1OBPSL > 10 TOBPDR . 

48 Aina 87 BELL U309 RWTS O3E3 LOCIOB Lines 190-195: The machine code 
ies ee oe 1770 BUFFER FDED COUT programs described above are 
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TIPS AND TECHNIQUES 


loaded into memory and _ various 
variables initialised. Then the menu 
is encountered which asks what kind 
of modification(s) is/are (more than 
one option can be selected) required. 
On pressing (Return) execution of 
any chosen option commences by 
checking the option flags (C(x)) at the 
beginning of each routine. 

Lines 209-299: Deleting the DOS: 
The VTOC is read into the buffer by 
initialising page @ locations for track 
17, sector @ and CALLing T/S MOD, 
checked it has not previously been 
modified and modified to free all the 
DOS sectors. Should the unused 
DOS sectors have been released 
previously, only those still occupied 
by the DOS image will be released. 
Upon modification, one of the 
unused bytes in the VTOC is used as 
a flag to indicate modifications so 
data is not lost should you try to 
modify the same disk again. The flag 
F1% is then set to indicate that the 
simple BOOT program (qv) is to be 
installed later. 

Lines 309-390: Freeing unused DOS 
sectors: As above but only the last 
11 sectors in track 2 are freed. Again 
a flag is inserted for future mis- 
management trapping! 

Lines 409-59@: Initialising track 35 
($23): The VTOC is checked to see 
whether or not Track 35 is in use by 
looking at byte $34; the value of 
which indicates the number of tracks 
on the disk. If equal to 34 ($23) then 
memory location 2 is POKEd with 35 
and FORMAT CALLed to format 
Track 35. The buffer is then modified 
at byte $35 and at the bit map of 
track 35 (bytes $C4 to $C7). 

Lines 599-57: Freeing catalog: The 
buffer image of the VTOC is checked 
for previous modifications and 
modified to indicate that sectors 1-14 
($1 to $E) on Track 17 ($11) are 
unused. Flag F2% is set to indicate 
that Track 17, sector 15 will need 
modification. 

Lines 609-670: The VTOC is written 
back to its place in sector Q, track 17 
from the buffer. If Flag F2% is set 
then Track 17 ($11), Sector 15 ($F) is 
then modified and the pointer bytes 
to the next catalog track and sector 
are set to @ to indicate that this is the 
last catalog sector. This will restrict 
the maximum number of file names 
on the disk to 7. Other values that 
can be used to POKE into the buffer 
so that more file names can be 


Program listing 4 


SPACE: More disk space under DOS 3.3 Page 2Z 
uo LUMEM: 4256 ; Set to pratect programs. 
10 FEM SPACE: & BASIC program using the TYS MOG and CURMAT 
Machine cade routines to create more Disk 
storage space under the Anpie Ji S02 3.35, 


; Please note tnat this 1 a dangerous program :# used inexpertiy. Data ioss 

+ Can accur especiali-v when cataiog sectors are reieased should there te mare 

; than © ¢ites creates an the diskette. Note that DELETED f:les aiso take us 

; catalog sector space and may accupy sector #F!' The best procedure is to apoiry 
; the modifications ta a BLANK ad:skette and then ta create filet cn it or copy 
; tiles anta it, 


20) REM 


5QO HOME :; V?PebiG os PRINTS SPACE : Mare Disk Space tar the Apole.” 


99 REM Initiaiise Constants. 


100 Dé = CHR#.4) : INN = 43864 : TSe= 5120 : RE =! We, = = In = 2 
110 TRe = 0.; SEX = i s: CH = 2 3s NTS = 35 WA = 284 


119 REM Load in Machine code Programs. 

120 PRINT O& "BLOAD Tr 3 MOD.OBJO" : PRINT Gt "BLOAD FORMAT. GBJG" 
ic? REM Print the Menu. 

130 HOME : FRINT* SPACE: 


Piease choose vour options be mumber: 


{....Gelete DOS from Tracks G-2. 
2....Free unused DOS sectors. 
3....Free Catalog sectors. 
4,...,imttialise Track 35, 

Jesse eRestart Program, 

S...,Quit, 


SPRLE: More Gist espace under O05 3,2 Page 3 
Lo? tt 2 FSU att 2 U 


“2s =o: Ch§ SdzQOs CK GH =HOQ 
iS? FEM Set desired chaices. 
140 YTAB 21 : KHTAB 6 : GET J# 


# = CHR#: 13) 200 Start Working. 


150 1 = VAL¢ T# ) + IF 141 OR I 5 THE ida ; Invalia Input rejected. 
160 IF = 2 THEN 130 ; Start Over. 
55 IF = 4 THEN HOME: END ; Wuit. 
“= 1 AND Cf 2 > THEN 140 ; Choices are incompat: bie, 
= 2 AND Ci 1 > THEN 140 2 ANC again! 
190 VIAB i #2 + 6 : HTAB io: 3"-3" ; Mark Choice aon Menu, 
195 Ce 3 = 7 : GOTO 14 Record Choice. 


179 REM Free ali DOS sectors routine. 


200 Fl’ = G :; F2% = 0 : HOME Initialise fiags. 


2US FOKE TR, iv : POKE SE%, 0 : VTQC lacation itrk i7,sec 0) 
210 POKE Cy, RY + TALL TS ; Retrieve it. 

220 IF NOT Cé i 3 THEN 300 ; Skip section if -not cnesen 
225 IF NOT PEEK 6047 5 THEN 230 ; Check for DOS DELETED marker 
227 PRINT" 


ERROR message it needed 
Control-J 1s used here, 
Since there is no DOS the 
section can be skipped’ 
Free Track l. 


DOS has already been deleted!" 
<22 GOTO 400 


Oe 28 wae (28 oa 


230 POKE 6060, 255 : POKE 6061, 255 


TIPS AND TECHNIQUES 


TF NOT PEEKS 6046 > THEN 260 


xX = PEEK“ 6065 > + 31 : POKE 6065, X 
GUTO 270 

POKE 6064, 255 : POKE 6065, 255 

POKE 6047, 255 

PRINT" 


Deleting DOS and releasing sectors" 
Fix = 1 : GUTO400 


REM Free unused DOS sectors Routine. 


IF NOT Cé 2 3 THEN 400 

IF PEEK* 6047 3 THEN 22? 

IF NOT PEBK* 6046 » THEN 350 
PRINT" 


Check if DOS Track 2 has 
been Partiaiiy ‘reed. 
Free onivy sectors U to 4 


Free Track Z. 
DOS DELETED marker. 


Set Flag 1. 


Skip section if not wanted. 
Check if DOS is no more! 
Check if DOS partially freed 


Unused DOS sectors have already been freed!" 


GOTO 500 
POKE 6064, 255 : POKE 6065, 224 
POKE 6046, 255 


Nn PRINT " 


Freeing unused DGS sectors" 


REM initiaiise Track 35 routine. 


TFOACT Ce 4 THEN =a0 
(Uo oiF FEEK. 4u52 1 = 35 THEM 440 
2201 PRINT" 
Track 35 aireagv in use:" 
i GOTO 507 
D FUKE TRY, WT 3: POKE SEM, 4% 
i PRint * 
imttialising Track 35." 


7 REM Free catata 


CALL ifh : IF PEEK! Ci 9 THEN 760 
POKE 4052, a6 . 
POKE 6176, 255 : POKE 6177, 255 


? PRINT “ 


Track 35 initial'sed,” 


track sectors routine. 


TF NOT Ceo 3 2 THEN 600 


i JF NOY PEEK ¢ 46045 > THEN 540 


520 PRINT" 


Catalog Track already itn use'" 


530 GOTO 606 


70 FIN = 2 


40 CALL TS% : IF PEEK C% > 
0 POKE 6001, 0 : POKE 4002, 0 
) PUKE C%, W% : CALL TSy 


POKE 4124, i127 : FORE e125, 254 
POKE 6045, 255 
PRINT " 


Freeing Catalog track’ 


>* FEM Reade and Writes. 


i) POKE TR%, 17 : POKE SE%, 0 : POKE CH, Wh 
0 CALL TS*% : IF PEEK. Cx 9 THEN 706 


IF NOT F2% THEN 710 
POKE SE%, 15 : POKE Cy, Rt 


THEN 706 


IF NOT PEEK* C% > THEN 130 


oe REM Errar Handiing § 


DISK QACCESS crROR! i: 


mo oIF WOT Fits THEN 3800 


ee -se 


"20° we we we 


Free unused Trk 2 DOS sectore 
And update VTOC Flag 


Skip section i¢ not wanted. 
Check Number of tracks. 
ERROR message if needed, 


Setup to INIT track 35. 


INI? and branch on error. 
Update na of tracks in VTOC 
Free Trk 35 in VTOC. 


Skip section if nat wanted. 
Check if Cat track in use. 
ERROR message if needed. 


rree sectors #1to#E on Trki7 
Set Fiag in VTOC. 


Set Fiag 2. 


Prepare to write ‘/TOC. 
Write & branch i¢ ERROR. 
To Menu if not Option 3. 
Setup to read cataiog sect 


Delete link to next sector, 
Write it back again. 


Fiaq ¢or de:eted 00S. 


listing continues 


traded for less space are given in the 
comment lines. 
Lines 799-719: This is where all 
errors in the machine code programs 
cause the program to jump to keep 
the user informed about the error 
status of the operation. 
Lines 720-819: This is a section of 
code that installs a BOOT ERROR 
message into track @ sector @ of 
disks where the DOS image has 
been deleted (flag F1% set). This 
measure is to inform the user he will 
not be able to BOOT DOS with the 
disk should he try to do so, and also 
to stop the drive motor from wearing 
out should a data disk have been left 
in the drive and power supplied to 
the computer with no-one in atten- 
dance. On attempted BOOTing, the 
computer will display an_ error 
message and stop the drive. The 
appropriate code and message is 
POKEd into the buffer memory after 
which the buffer is written to the disk. 
Otherwise the programs are well 
annotated and _ “self explanatory. 
These programs work and can be 
used as they are. Some special 
editing techniques were used in the 
BASIC programs to make them 
appear more readable but, except 
perhaps for line 13@ (Menu) in 
SPACE, they can be copied without 
the semicolon comment lines and 
will work. If all the comments are 
desired, the semicolons can be 
replaced with :REM — statements 
which will work with standard 
Applesoft. 


Miscellaneous 


It should be noted that modifying 
the DOS, the catalog sectors and the 
VTOC may cause incompatibilities 
with certain commercial disk utility 
programs. These are basically 
programs that copy disks, fix up the 
VTOC if it should be damaged and 
provide other functions such as 
telling how much space is left in the 
disk, etc. Most copy programs work 
very well with SPACE disks. 

Programs known to cause minor 
problems are: 

Bag of Tricks: This excellent set of 
programs assumes a standard disk 
format and refuses to _ function 
beyond track 34. The Fixcat program 
will restore the disk to its standard 
DOS configuration; data in Tracks 17 
and 35 will be lost if this is used, as 


29 


ARTICLE 


by Duncan McCann 


Disk drives in the future 


nce you have used your 
O) computer to work on a 

program you have to save it. 
When Apple first started, information 
had to be saved laboriously to a 
cassette tape recorder. Take it from 
one who suffered that it was not 
easy. 

It is interesting that cassette 
storage is still the major means of 
saving information from computers 
in Australia, but not on Apples. 

Almost immediately after the 
launch of the Apple II came the Disk 
Il floppy disk drive. This was a 
Shugart drive, and when it was 
introduced by Apple in 1978 it swept 
all before it. 

It was designed by Steve Wozniak, 
co-founder of Apple, and it Is 


considered by many to be one of the 
great engineering accomplishments 
in personal computers. 

Wozniak designed a revolutionary 
disk drive controller and the electronic 
circuit necessary to operate the disk 
drive during the week between 
Christmas and New Years Day in 
1977. His disk controller was much 


less expensive and far more reliable 
than anything else that had been 
developed. 

Within three months of Wozniak 
designing the disk controller, Apple 
became the world’s largest producer 
of 5.25 inch (13.2 cm) floppy disk 
drives. 


TIPS AND TECHNIQUES 


storage 


Program listing 4 continued 


7i7 FEM oOSless BOUT error message instaiatioan 


Section, 


faults; it will not initialise that extra 
track when its Initialise function is 
selected and, should you use the Fix 
File Size option, all tack 1,2 and 17 


sectors will become _— protected 

72t RESTORE whether they have been used or not; 
cel reyes? data is not lost on any tracks. The 
inetard ae Bact ERROR mes ean” disk space left displays are accurate 

740 S# = “This Diskette nas no GOS on this side.” ; DCSiess BOOT ERROR and copying works well. (Oddly, 
745 Mé = CHREC 12 3 : St = 38 + Me + Me tracks 1 and 2 are only protected if 
7O0 S# = 3# + "Please Re-BUOT using anather one." no program occupies them; Super 


Yoo FOR IT = 6000 TG side 
760 PEAD Po: POKE IT, Peo: NEXT 
Yoo FOR $ = 1 To 7o 


7?O POKE S042 + 7, AST! Mibec St, 1,1 '. 
?7o FORE 6112,0 

78U POKE TRH, 3 9: POKE SE, C : 

7?G CALL Ts% : IF PEEKS &% 3 THEN 700 
200 PRINT * 


Hit any Ker ta continue.” 
8190 GET t# : GOTO {30 


well aS space (no data) in track 2 if 
DOS has been partially freed. In 
short these programs are to be 
avoided on SPACE disks. 

Reconstruct VTOC: This program 
will rewrite the VITOC and all codes 
and flags put in by the SPACE 
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POKE Ch, Wh 


; ingstaii SOOT code in Butter, 


; Write Cede ta diskette 
" 


: track 0, Sector U. 


program will be lost. Track 35 may 
also become hidden and data on 
Track 17 may be lost. To be avoided. 
Super Copy: This program works 
exceptionally well and even displays 
the new additional track on its Track/ 
sector map. There are only two 


Copy then probably assumes that 
the DOS image occupies them. If Fix 
File Sizes are used on a partially 
deleted DOS, free sectors on track 2 
are lost although the data Is not). 

In conclusion, most programs | 
have used 35 track disks with have 
worked well with no problems, but it 
is well worth experimenting a little 
with your particular programs before 
entrusting valuable information to the 
cunning wiles of the monster 
computer. As with all things in life, it 
is well to back up everything well 
using something that is known to 
work before launching off into new 
ventures. O 
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Basic idea 


Very basically, the floppy disk 
works from a flat circular plate of 
plastic coated with metallic oxide 
which is capable of holding a 
magnetic charge. 

This circular plate is encased in a 
Square plastic cover to protect it from 
dirty fingerprints, dust and cigarette 
ash. The square cover has a large 
circular hole in the centre which 
allows the diskette within to be 
rotated. 

The Apple Il diskette rotates 
above the read/write head at 300 
revs per minute. The head moves in 
and out over different concentric 
tracks of the disk. 

Because they have limited the 
speed of rotation of the disk to a 
level where mechanical problems do 
not affect the rate at which data is 
stored, Apple floppy disk drives are a 
relatively slow method of storing 
permanent data. 

On a standard Apple II disk drive 
there are 35 tracks and these tracks 
are about @.5 millimetres apart. 

The read/write head uses only a 
portion of this width to allow some 
flexibility in the positioning of the 
disk and to allow for differences 
between drives. 


Major developments 


Since Wozniak devised the stan- 
dard Apple II drive there have been 
major developments. 

No matter how quickly memory 
prices fall, uses for the memory 
increase far more rapidly. AppleSoft 
Basic, which took over from Integer 
Basic on the original machine, took 
up more memory. 

The new operating system 
ProDOS, which has taken over from 
DOS 3.3, takes up more memory. 

Programs which once used to 
take up two or three K now require 
multiples of memory in order to 
operate properly. In the newer Apple 
machines this problem is even more 
acute. 

The Macintosh in its. original 
release had 128K of RAM, but many 
of the programs available for that 
machine fill up that space with ease. 

As soon as the 256K RAM chips 
are available at the end of the year, 
the Macintosh is going to be 
operated so there is half a megabyte 
of memory available for programs. 


Even the Lisa in its highest 
configuration, providing as it does a 
megabyte of memory, does not leave 
enough room for the entire operating 
system and common utilities to fit 
into the memory at the same time. 


Holding pattern 


The result of this is that one of the 
functions of a disk storage system is 
to hold sections of programs and 
information too big to fit into the 
computers active memory. 

How long this situation will 
continue depends on the speed with 
which the Random Access Memory 
on computers is expanded. 

In this particular use the disk and 
the disk drive are frequently being 
made to act as if they were a Read 
Only Memory chip. 

In this mode two aspects are 
absolutely vital. One is speed and 
the other is reliability. 

Speed is important because the 
speed of the disk drive is very 
frequently the major factor retarding 
the speed of operation of a 
computer. If a delay in obtaining 
information lasts more than a second 
the users attention starts to drift. 

Reliability is obviously just as 
important. ; 

Sadly, speed and reliability tend to 
be inversely related. 

At Apple the decision has been 
that they will have reliability first and 
speed second. 

The disk drives’ invented’ by 
Wozniak were roughly comparable in 
speed to other drives of the same 
time. But they are much slower than 
many of the drives that have been 
introduced in later years. 


Slim drives 


First of all, we have seen the slim 
line drives which have come out of 
Asia like Genghis Khan. 

They provide the same amount of 
memory as a standard Apple disk 
drive but they take up less space. 

Even more useful are a series of 
disk drives made by Rana. These are 
the Rana Elite series. 

There are three versions: the Elite 
|| a 35/4@ track drive; the Elite Il, a 
double sided single density 8 track 
drive; the Elite Ill, a double sided 
double density 16@ track drive. They 
are imported 
CompuMusic. 


into Australia by 


To allow these drives to be used 
effectively Rana also produces a 
disk controller and a_ utility for 
modifying DOS to work with the 
drives. 

All three Rana drives are very 
similar in styling to the Apple Disk II 
but are about a centimetre taller. All 
three versions use the same kind of 
door mechanism as the Apple Disk II 
- the door latch closes the drive, 
centres the disk, engages the hub 
and places the head above the disk. 


Small advantage 


With the Rana Elite | you have a 
single sided, single density 4@ track 
drive which is almost precisely the 
same as the standard Apple | until 
you modify the DOS. Then instead of 
using 35 tracks you end up using 40 
tracks, which increases the storage 
capacity by 20K. This is not a major 
memory advantage. 

The Rana Elite I! is similar to the 
Elite |, except it can write to both 
sides of the disk and therefore has 
89 tracks. Since it is single density it 
can read and write to the ordinary 35 
tracks as well. 

The result is a machine which 
gives you over double the amount of 
disk space available on the standard 
Apple drives. 

Finally there is the Rana Elite Ill, 
which is both double sided and 
double density. It has 8@ tracks on 
each side, a total of 16 tracks. In 
effect, this gives you four times the 
amount of memory area on a disk 
that you get on a standard Apple II 
drive. 

To run it you need a Rana disk 
controller, which can control up to 
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four drives when you are using the 
modified version of DOS. Without the 
modified DOS only two drives are 
accessible. The Rana disk controller 
can also control the standard Apple 
Disk II drive and its many clones. 

The problem with these drives is, 
as always, the cost. 

It is true that you can cram an 
immense amount of information onto 
the drives and it is true that they are 
extremely reliable. But in the end you 
have to look at the cost per kilobyte 
stored. And it may be that except in 
semi-professional situations the cost 
is too high. 


Amazing developments 


However, Rana is an amazing 
company which keeps on improving 
its products to keep up to the level of 
progress within the personal com- 
puter industry. 

Soon to be available in Australia 
from CompuMusic is the quite 
staggering Rana 8986/2 co-pro- 
cessor dual drive for the Apple //e 
which takes the Apple //e into a 
different area of personal computing 
altogether. 

First of all, the two single unit 
drives can either operate as standard 
Apple II drives, each storing 143K of 
information. Or they can operate 
under ProDOS - Apple's relatively 
new operating system — and will then 
give 320K of storage space. Or, and 
this is where the system gets 
interesting, they will run under the 
IBM compatible MS-DOS as a pair 
of double sided double density 
drives. 

When working under MS-DOS the 
drives work through an 8986 18 bit 
microprocessor which makes the 
Apple think that itis an IBM clone. 

Indeed, slightly better than that. 
Because the 8986 works at higher 
speed than IBM's Intel 8988 
microprocessor. And built into the 
board is an incredible 256K of 
Random Access Memory which can 
be expanded to 512K. 


Available software 


Software is available to support all 
these amazing features and also to 
allow the use of CP/M and Pascal. 
The makers claim, and we think itt is 
perfectly feasible, that it: 

"allows data and text files to be 
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Lisa with Profile hard disk drive (far left), Apple III with Unifile disk drive 


(middle) and the Apple Ile with the disk drive II. 


written on other MS-DOS machines 
to be brought over to the 8086/2, 
and to be read or written directly 
without modification. This lends a 
very high degree of portability to the 
user in business and _ professional 
environments.” 

Forget for the moment. the 
American computerspeak involved 
in that statement and concentrate on 
the facts. 

If they are true it may well be that 
once the whole system has been 
properly installed you will have an 
Apple //e that thinks it is an IBM and 
runs all the IBM programs — only 
faster. And still operates perfectly 
well as an Apple //e — but with 
Superior disk drives. 

We have not tested this system 
yet, but knowing the reputation of 
Rana we are fairly confident the 
whole package will work as adver- 
tised. Which will mean a minor 
revolution for Apple. For the first time 
you will be able to have your cake 
and eat it as well. 


Microfloppies 


We have seen_ microfloppies 
being produced in Taiwan which 
were double sided, double density 
and which cram one megabyte of 
information onto a 9 cm micro floppy 
disk. In Taiwan they were selling for 
less than $19@ each. Now that is 
what we call cheap, high capacity 
storage. 

Quality is another matter. And we 
wont see those drives available in 
Australia until sometime next year, 
when they will be priced at $209. 

Hard disks can spin their disks far 
more quickly than any floppy, micro 


or otherwise, and as a result they cut 
waiting time. They also allow faster 
data transfer as well. 

The Apple Il family was never 
originally designed to take hard 
disks, although the Lisa and the 
Macintosh were both created to work 
in this environment. 

Apple, keeping to their tradition of 
safety before speed, have one of the 
slower hard disk drives on the 
market in the Apple ProFile. 

The technology of the hard disk is 
very similar to that of a floppy disk 
but there are radical differences: 

1) The disks instead of being 
made of mylar or some other plastic 
are normally made of aluminium 
alloys. 

2) These platters have extremely 
thin coatings of iron oxide to take the 
magnetic charge. A coating that Is 
far thinner than on the standard 
floppy disks. 

3) The disk operates at about 3,60 
Q rom versus about 300 rpm for 
floppy disk drives. 

4) The read/write head never 
actually comes in touch with the 
rapidly rotating disk. It flies on a very 
thin cushion of air, and never comes 
to rest on the information area of the 
hard disk. 

5) The read/write heads rest in a 
specially prepared landing zone. 

6) The whole of the storage disk, 
the read/write heads and_ the 
positioning mechanism are enclosed 
in a sealed environment so that dust, 
dirt and other polluting elements 
cannot enter. 


Significant increase 
Working on the basis that five 
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megabytes is the equivalent of about 
35 diskettes, you can see it is a 
significant increase in memory. It Is 
also a significant increase in speed 
of access because the information is 
collected in hundredths of mill- 
seconds as opposed to milliseconds. 

Although initially hard disk drives 
can seem extremely expensive, if you 
make a comparison with the 
equivalent number of floppy disk 
drives they work out relatively cheap. 

The main problem with hard disk 
drives is backing up the information. 

You can either do selective back- 
ups, which means that you record 
any important files that have been 
changed since last time they were 
backed up. 

Or you can use an_ external 
cartridge tape drive which will allow 
the whole of the hard disk content to 
be recorded on removable tape. 

In the past year or so several 
companies have been announcing 
removable cartridge hard disk drives. 
These drives offer the advantages of 
a hard disk plus the convenience of 
the removability of floppies. At the 
moment they are extremely expen- 
sive, but there is no doubt that in the 
near future we will be seeing this 
option offered at a reasonable price. 

The theory behind the hard disk 
design is that because the read/write 
head is coming extremely close to 
the disk’s coating at high speed it 
decreases the time the head needs 
to find information. At the same time 
it allows for a density of about 24 
tracks per millimetre, compared with 
something between 2 and 4 tracks 
per millimetre on a floppy disk drive. 

This means that you can measure 
the times for seeking information on 
a hard disk in milliseconds instead 
of hundreds of milliseconds on a 
floppy disk. 


High transfer rate 


At the same time hard disks give a 
data transfer rate of megabytes per 
second, which makes hard disks 
relatively efficient in operations 
where disks are continuously being 
accessed. 

However there is a down side to 
the situation. 

Because of the close mechanical 
tolerances involved everything must 
be kept absolutely spotless, otherwise 
you get a head crash. 


When that happens the data get 
zapped, and zapped permanently. 

The problem was much more 
serious with early hard disk tech- 
nology, but nowadays disk drives are 
so well sealed that problems are 
relatively rare. 

However, the use of a back-up Is 
still recommended at all times. 

Another way around the speed of 
access problem is to use a RAM 
disk emulator board, which may one 
day incorporate semi-permament 
memory. 

There is still much to be done with 
the ability of the machine to save 
data and programs once you turn its 
power off. 

Apple computers of course have 
some built In permanent memory in 
their Read Only Memory, but the 
Random Access Memory in the 
computer loses its contents the 
moment you turn off the power. 

There is no doubt this is the area 
where there will be changes in the 
near future, as CMOS technology 
allows RAM chips to retain their 
memory. 


No moving parts 


The computer accepts the fact 
that this memory is a disk drive but 
because there is no mechanical! 
operation involved the wait for 
information to be retrieved is 
invisible to the human eye. 

By using disk memory instead of 
the main memory, RAM pseudo 
disks can use existing software that 
expects to access information on a 
continuing basis from disks. Whether 
you use them as memory extension 
for programs or whether you use 
them as a place in which to load the 
operating system of the program, or 
indeed, both, the fake RAM disks 
give an outstanding combination of 
reliability and speed. 

Delays are almost negligible and 
the transfer rate is usually as fast as 
the machine’s ability to accept 
information. As we get bigger and 
bigger Random Access Memory 
chips, SO we are going to get more 
and more Random Access Memory 
pseudo disk systems. 

You have excellent reliability 
because on a RAM pseudo disk 
there are absolutely no moving parts. 
The data and information is only read 
in once. After that you can read and 


write data as frequently as you like 
and it will not wear out. 


Speed and reliability 


Equally, a RAM disk board will 
never lose a bit of data unless you 
have a complete chip failure or some 
other hardware problems. 

After speed and reliability comes 
Capacity. 

Just as software is continuing to 
overflow available main memory, the 
amount of data that can be stored on 
disk grows ever larger. 

One of the major considerations is 
how much information you can 
access at any time. 

The amount of data information 
that a disk drive can store depends 
on the design of the disk drive and 
how the information is encoded into 
bit patterns. 

Again there is a balance between 
reliability and density. 

Denser storage allows less room 
for slight errors and is thus inherently 
less reliable. 

At this moment nobody is actually 
sure in which direction mass storage 
for Apples is going to go. 

There is no doubt that a higher 
capacity floppy disk drive for the 
Apple |! family has been overdue for 
some time, and even the 10 
megabyte hard disk drive on the Lisa 
has had to be extended towards the 
35 megabyte range. 


The future 


The probability is that we are 
going to see some of the high 
capacity 13 cm floppy disks and 
9cm micro floppy disks as standard 
with the Apple I! family in the very 
near future. 

Probably we will see a lot more 
RAM disks when the 256K RAM 
chips are available. We may see hard 
disks built into the machine with 
Capacities in excess of 5@ mega 
bytes. That is our guess. Your guess 
is probably as good as ours. 0 
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The first Computer Of The Year that won’t 
be out of date by next year. 


The highly respected “Your Computer” 


magazine has just named the Apple Lisa as 
Computer Of The Year, 1984. 


In their own words, “People will remember 


1983 as the year that Lisa revolutionised 


personal computing. 


Surely good news for the business on the 
verge of choosing the ideal system. 


In the frantic, fast-moving world of micro 


technology, where new models are here today 
and gone this afternoon, Lisa seems to be a 
reassuring exception. 


This is the most advanced personal 
computer in the world, with up to one million 
bytes of internal memory. 


Unlike conventional computers, Lisa 
works visually, the way you do. Those complex 
computer commands are replaced with familiar 
symbols and a palm-sized mouse. 


Countless man-hours are saved because 
Lisa starts being productive from the moment 
it’s switched on. (Even for staff who’ve never 
used a computer before.) 


Little technical miracles like these don’t 
exactly happen overnight. 


Considering they’ve taken us a good five 
years to perfect, even if our competitors simply 
copy, they should be kept busy for some time. 


There are three Lisa models of varying 
price and capacity, any one of which your Apple 
dealer would be proud to demonstrate. 


You probably won't be the only company 
moving to Lisa technology this year. 


We expect quite a few of our apple 
competitors will be doing likewise. ..:..:.:~. 


Number Farm/Rodeo/Circus 


Number Farm 


ow available for the Apple Il, 
N Il+ and //e microcomputers is 
an educational game for 
children up to seven years of age. 
Called Number Farm, the game 
helos parents to teach their children 
how to count. Parents are an integral 
part of this pjrogram. Put a child in 
front of the computer with this disk 
running and he will not know what to 
do. He can not be expected to, 
because any child who is old 
enough to read the instructions for 
himself will not find this program of 
any use. 

This program allows the child to 
sit on his fathers lap following the 
directions which his father reads for 
him from the screen and interprets 
for him if necessary. The child can 
then learn something about the 
keyboard as he inputs the numbers 
the computer asks for. 

A farmer usually stays on screen 
raising his arms or, on- rare 
occasions, raising his hat to reveal a 
part running straight down the mid- 
dle of his head. 

The sound effects are good. The 
program plays music. One of the 
games features the barking of a dog 
and the mooing of a cow. As the far- 
mer raises his hand to his ear to lis- 
ten to the mooing the child can listen 
for the moos or simply watch to see 
how often the cow opens its mouth 
to moo. Then the child answers the 
question of how many times the cow 
mooed. If he gets the number wrong 
then the farmer asks him again.. 

In the guessing game, the child is 
asked to guess how many eggs have 
been laid by the nine chickens on 
screen. When the child guesses he 
is told either his answer is too low, 
too high or is the correct number. 
This allows the child to exercise his 
mind in the use of numbers. 

The child inputs the number by 
pressing the appropriate key on the 
keyboard. Thus the sequence in 
which the keys are arranged on the 
keyboard reinforces, in the child's 
mind, the concept of numbers being 
in a specific order. 

To run the program you need an 
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Apple Il, Il+ or //e with 48K memory, 
a disk drive and a, preferably colour, 
monitor or television screen. 


Shape and Color Rodeo 


This program is available for the 
Apple Il, Il+ and //e computers. 

Designed for the under seven year 
old, this game displays various 
shapes and colours for the child to 
identify. And because the program 
teaches children to identify colours, 
a colour monitor and RGB card are 
essential. The instruction booklet 
tells you what is needed to run the 
program, as well as giving a run- 
down of each of the games. 

The shapes used are a square, 
triangle, star, rectangle and two 
shapes which resemble a circie and 
an oval. 

lf you have a colour monitor, then 
this game should be helpful in teach- 
ing your child how to _ identifty 
colours. But, initially, it is you who 
has to name the colours. The instruc- 
tion booklet also recommends the 
use of the cue card included and 
crayons. 


Alphabet Circus 


In thts program the use of a colour 
monitor is not nearly as important 
because the program ts designed to 
teach your child the alphabet. Hav- 
ing colour helps, of course, because 
it holds the child’s attention. 


“ie 


The program starts with a tiger 
jumping through a hoop held by the 
master of ceremonies. He is present 
throughout the program to en- 
courage your child as he learns to 
identify letters of the alphabet and 
arrange them in their conventional 
order. But you are also needed not 
only to read the instuctions but to tell 
the child what the letter sounds like. 
The program provides sound but 
only in the form of music and if you 
want the child to learn the names of 
the letters the computer will not 
speak them to him. You have to do 
that. 

In one of the games, Marquee 
Maker, the child tyoes a message 
onto the screen. It is printed in little 
letters halfway down the screen 
while it appears in big letters at the 
top of the screen. Pressing the space 
bar removes the word from the big 
lettered screen to make space for the 
next word. The big letter screen will 
take a maximum of 12 characters so 
your child will not be able to type in 
“schizomycetes”. The small letter 
screen Is restricted to 3/7 characters 
so the child will not be able to type 
the “To be or not to be” speech from 
Hamlet. 

But if you want all that then you 
want a word processing program 
and this program was not designed 
for anyone that skilled. 

All three of these programs were 
designed for very young children. So 
they are not designed for people 
who can be left to work the computer 
on their own; using them is going to 
require a lot of time and patience of 
the parent's part. The trick is to treat 
the learning process as a game and 
these programs do that with interest 
ing graphics and music. 

These programs are only as good 
as parents can make them. But if the 
parent is willing to persevere and is 
willing to play around with pens, 
paper and crayons then these pro- 
grams can be a help in teaching kids 
the basics of the computer keyboard 
and number system. 

The programs are produced by 
DLM, under the Early Childhood 
Software label and distributed by 
Dataflow. They retail at $39.95 each. 


PROGRAMMING 


A Pot-pourri of Apple 


by Derek Chan 


Apple Colours 


veryone knows that the Apple 
Hy: capable of displaying 16 

colours in the Low Resolution 
Graphics Mode (Lo-Res) and 6 
colours in the High Resolution 
Graphics Mode (Hi-Res). Well, this is 
not strictly correct as the following 
short program will illustrate — tap it 
into your Apple and see for yourself! 


19 HOME: HGR 

20 FOR COL= @ TO 255 

3M POKE 228,COL 

49 HPLOT 0,0 : CALL 62454 

5M VTAB 23 

62 PRINT “COLOUR CODE = 
“;SCOL: PRINT 

7@ PRINT “HIT ANY KEY TO 
CONTINUE “; 

80 GET K$ : HOME 

99 NEXT 

109 TEXT: HOME 


The memory location 228 (hext- 
decimal $E4) contains the colour 
code for the colour specified by the 
APPLESOFT statement ‘HCOLOR =’. 
For example, when HCOLOR = 1 
(green) the value 42 will be stored in 
location 228 ($E4). In the FOR..NEXT 
loop we try out all possigle values of 
the colour code @ to 225 ($0@ to 
$FF). Enjoy the colours, some of 
them are rather pretty. 

In the APPLE ROM there are 
loads of high quality software or 
firmware (the Editor will surely make 
me do penance for using computer- 
ese) that good programmers should 
use. After all, why try to reinvent the 
wheel when it's been done for you for 
free. Line 49 is one such example. 
There is a MONITOR subroutine 
called BKGND with entry point 
62454 which fills the Hi-Res screen 
with the last HPLOTted colour. This is 
considerably faster than trying to 
accomplish the same task with 
HPLOT statements. Do compare if 
you are sceptical. 


delights 


HI-RES pages 


The APPLESOFT Manual tells us 
that there are two High Resolution 
Graphics Pages. These can be 
invoked by the APPLESOFT com- 
mands HGR for Hi-Res Page 1 and 
HGR2 for Hi-Res Page 2. Internally 
APPLESOFT keeps track of which of 
the two Hi-Res Pages to draw on, for 
instance in response to a HPLOT 
statement, by storing an appropriate 
number in the location 23Q ($E6). 
This memory location is called 
HPAG. 

lf graphics outputs are to be sent 
to Hi-Res Page 1 the content of 
HPAG will be the number 32 ($20); if 
Hi-Res Page 2 is to be used HPAG 
will contain 64 ($49). This is true 
irrespective of which Hi-Res Page is 
being displayed. 


‘Why try to reinvent the 
wheel when it’s been done 


Sor you free’ 


The standard technique of pro 
ducing smooth flicker-free graphics 
animation is to draw and display 
successive frames of the moving 
picture alternately on the two Hi-Res 
Pages. That is, we display a frame on 
Page 1 while drawing the next frame 
on Page 2 while the following frame 
Is being composed on Page 1. This 
is repeated to give a smooth 
animation sequence. 

The curious Apple devotee may 
ask: Where will the graphics output 
go if other values are stored in 
HPAG? The answer is, not sur 
prisingly, to Hi-Res Pages 3 or 4 or 5. 
No, there have been no misprints! 

The Apple Hi-Res Graphics 
system is Memory Mapped. This 


simply means the hardware circuitry 
has been constructed to display the 
numerical content of specially 
designated memory locations as 
dots on the video screen. Hi-Res 
Page 1 corresponds to the locations 
$2000- $3FFF; while Page 2 
corresponds to $499Q-$5 FFF. 

Now if the value 96 ($6Q) is stored 
in HPAG, Hi-Res Page 3 ($600Q- 
$7FFF) will be used for graphical 
outputs; the value 128 ($8) will get 
us Page 4 ($809Q-$9FFF) while 160 
($A) in HPAG will get us Page 5 
(SAQ00-$ BFFF). 


‘We have effectively 
changed the value of the 
Y-Register’ 


WARNING: Drawing to Pages 4 
and § will trample over DOS unless 
DOS has been moved to _ the 
language card area. With DOS active 
the highest available memory 
(HIMEM) is $9609. 

There is, however, no way for the 
Apple hardware to access Pages 3-5 
directly. To display these pages, the 
content of these pages must be 
copied onto Pages 1 or 2 and then 
displayed as usual. 

| will leave it to the curious reader 
to explore the effects of storing other 
values in HPAG. The hexidecimal 
values of the content of HPAG and 
the starting address of the Hi-Res 
Pages look interesting. | ‘would 
strongly suggest saving any such 
exploratory progams BEFORE actu 
ally running them — otherwise the 
consequences may be blood curd- 
ling! Don't forget tos set HIMEM 
accordingly..Write in and share your 
interesting experiences with these 
extra Hi-Res Pages. 


‘Experiences with these 
extra Hi-Res Pages’ 
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PROGRAMMING 


Text/Graphics Soft 
Switches 


These are not the results of short 
circuiting your Apple. 

These are peculiar memory 
locations that have intimate links 
with the Apple hardware. By writing 
to these memory locations it is 
possible to make the Apple do 
interesting things. 

The general way to use these soft 
switches in APPLESOFT is by the 
statement: 


POKE SWITCH, @ 


The value of SWITCH depends on 
what we would like to do. What is 
being written to these memory 
locations or SOFT SWITCHES is 
irrelevant - so Q is as good as any 
value. The TEXT/GRAPHICS SOFT 
SWITCHES are the eight locations 
49232-49239 ($CQ50-$CM57). These 
allow us to select between: 


1. Text or 
Display. 

2. Full screen graphics OR Mixed 
Graphics and Text 

3. Display Page 1 OR Page 2. These 
may be Page 1 or 2 of the Graphics 
or Text screen depending on 
whether Graphics or Text Mode is 
being selected. 

4. Hi-Res OR Lo-Res Graphics. 


Graphics Modes OR 


‘In a family computing 
magazine I am not 
permitted to be more 
explicit’ 


The value of the switches are as 
follows. 


Effect Switch 
Graphics Mode 49232 
Text Mode 49233 
Full Screen Graphics 49234 
Mixed Text/Graphics 49235 
Page 1 49236 
Page 2 49237 
Lo-Res Graphics 49238 
Hi-Res Graphics 49239 


For example, to select Full Screen 
Hi-Res Graphics Page 1 we execute 
the program segment: 


POKE 492320 Graphics Mode 
POKE 49234,0 Full Screen 
POKE 49236,0 Page 1 
POKE 49239,0 Hi-Res 

Note the Text/Graphics Mode 


switch should always be selected 
first. For the other switches, once 
selected they do not have to be re 
selected unless changes are desired. 
For instance, in Graphics Animations 
we may want to display Page 1(2) 
while we draw on Page 2(1). This can 
be accomplished by the pair of 
statements: 


POKE 230,32 Draw on Page 1 
POKE 49237,0 Display Page 2 
POKE 239,64 Draw on Page 2 
POKE 49236,0 Display Page 1 
‘Smooth flicker-free 


graphics animation’ 


Moving Memory 


This is not a reminiscence about 
an encounter with Robert Redford or 
Bo Derek or Boy George - 
depending on your predelictions. In 
a family computing magazine | am 
not permitted to be more explicit. 

On occasions you may like to 
move the contents of a block of 
memory to another location. For 
example, you may want to move a 
picture you have drawn on Hi-Res 
Page 3 to Page 2 to be displayed. 
This can, of course, be done by 
PEEKs and POKEs as follows: 


For |= START TO FINISH 
POKE (DEST+START-1) , PEEK (1) 
NEXT 


where the source data is in between 
memory locations START and 
FINISH; and DEST is the starting 
address of the destination location. 
Unfortunately this method tends to 
be unacceptably slow. 

An alternative is to use the 
subroutine in the MONITOR in ROM. 
This subroutine is called MOVE - 
entry point -468 ($FE2C). In fact, 
MOVE is a misnomer. The content of 
a specified block of memory is 
COPIED to another location; but the 
Original memory remains unaltered. 


In order to use MOVE we need to 
specify the various addresses: 


1. The two bytes STARTing address 
must be stored in locations 6@ and 
61 in the usual low byte first 
convention. The locations 6@ and 61 
are referred to as Ai in the official 
Apple literature. 

2. The FINISHing address must be in 
locations 62 and 63 which are 
known as Ad. 

3. The DESTination address must be 
in locations 66 and 67, known as A4. 
4. The Y-Register of the 6592 Central 
Processor Unit (CPU) must be set to 


The above data can be set up with 
the program segment: 


1 POKE 6%, START — INT(START/ 
256)*256: 
POKE 61, INT (START/256) 


2 POKE 62, FINISH — INT(FINISH/ 
256)*256: 
POKE 63, INT (FINISH/256) 


3 POKE 66, DEST - INT (DEST/ 
256)*256: 
POKE 67, INT (DEST/256) 


4 CALL-182: POKE 71,0: CALL-193 
5 CALL-468: REM Call MOVE 


Line 4 has the effect of storing aQ 
in the Y-Register of the 6502 CPU. 
Since there are no direct ways of 
storing values in the Y-Register in 
APPLESOFT, we call on two other 
subroutines in the MONITOR ROM. 
The first one is called SAVE (-182) 
which SAVEs all the contents of all 
the internal registers of the CPU in 
predetermined memory locations in 
RAM. In particular, the content of the 
Y-Register is SAVEd at location 71. 
The other subroutine we used in line 
4 is RESTORE (-193), which as the 
name suggests does the exact 
opposite of SAVE. Thus, by changing 
the value of location 71 between a 
call to SAVE and a call to RESTORE, 
we have effectively changed the 
value of the Y- Register. 

If you haven't noticed, you have 
just been manipulating the CORE OF 
THE APPLE - that is the 6592 CPU 
directly. It hasn't been too painful, 
has it? O 


GAME REVIEW 


Brian Hammerhead is the 
‘Hell fire Warrior” 


by Alan Fenton 


Hardware: 48K and 1 disk 
Language: Applesoft / Assembly 
Company: Automated Simulations 
Graphics: Hi-Res 


he adventure game_ Hellfire 

Warrior consists of levels 5 to 8 

from The Temple of Apshai: 
however, Hellfire Warrior is an entire 
game on its own, so knowledge of 
the Temple of Apshai is not needed. 

First we visit the Innkeeper, where 
we can make a character composed 
of the following; intelligence, intuition, 
ego, strength, constitution and 
dexterity. These attributes range from 
about 8 to 18 and help decide how 
your Character will perform (strength 
determines how much weight can be 
carried). 

About 259 gold Royals are 
Supplied and a name of your choice. 
If you have a character from Temple 
of Apshai or want to make a super 
warrior, then the Innkeeper allows 
you to make your own character with 
weapons and armour. A _ stored 
character can also be loaded. 

Next a visit to Gulik the armourer 
to haggle, for in the shops objects 
have a weight, quantity available and 
offered price. The price can be 
haggled over with the storekeepers, 
who argue briskly, and are not 
always complimentary. The armoury 
offers a sword, armour (from leather 
to full plate), shields of two sizes and 
bows with arrows. 

Fnord’s apothecary shop offers 
magic potions to boost your attri 
butes. The effects usually last until 
you come back from your adventure; 
some are permanent. Which potion 
does what is a problem to amuse 
you for a while. | suggest using one 
potion at a time and recording the 
results, ie, +1 to ego, entering level 5 
and returning. Go through the same 
procedure twice or maybe _ three 
times with each potion. 


Malaclypse the mage _ (wizard) 
offers magic to add from +1 to +9 to 
your sword and/or armour, making it 
better for killing, magic-using or 
creating monsters. Magic objects are 
offered, like seven-league boots 
which let you run faster without tiring 
as easily, magic arrows and a few 
other objects. 

The quest is to rescue Brynhild 
the warrior queen. She is sleeping in 
a deep cavern waiting to be brought 
into the sunlight, which will awaken 
her from her nine hundred year 
sleep. 


‘Which portion does what 


is a problem to amuse you 
for a while’ 


A story of Brian’. Hammerhead sets 
you in the right mood for the quest. 
Graphics are Hi-Res and in colour. 
On the screen on the left side a 
display like a house plan of the 
immediate area shows yourself (a 
person with a sword) and a monster. 
One way of mapping is to trace off 
the screen, a good use for the back 
of printer paper. The right upper 
corner displays room number (when 
applicable), wounds (get down to @ 
and you're dead), fatigue (too tired 
and you cant move), weight of 
objects carried, arrows available, 
magic arrows available, name _ of 
monster attacking you, the number of 
your slain victims and a letter of the 
last desired action that your character 
performed. Movement is from the 
keyboard with different letters for the 
actions. A command summary card 
is supplied to prop before you. 

Level 5 monsters mainly consist of 
giant insects. Level 6 is a maze with 
a hidden exit. Level 7 monsters (the 
undead variety) can make life very 
hazardous (running is a_ useful 
defence). A key has to be found to be 
used in level 8. 


In level 8 the screen is mostly 
black — you are wandering in a vast 
cavern of hell. After getting a certain 
treasure you have to go in a certain 
direction to find the entrance to the 
final cave. At the entrance is a nine 
headed Hydra which can ruin your 
health something terrible. Run by it 
and “O” pen the door, but only if you 
have the key from level 7. 

On the way a treasure consisting 
of gems and armour melted together 
(Someone muffed it) should be left 
behind because it is too heavy to 
carry with Brynhild. One day | 
retrieved the treasure and _ left 
Brynhild behind and got a fortune 
from the Innkeeper. 

Treasures are found in different 
places, and when “G’et is used, a 
treasure number flashes on. the 
screen which has a description for 
the appropriate level. 

The game can be saved at any 
time or the character only after it has 
sold its treasure at the Inn. 

Hellfire Warrior consists of one 
command summary card, one 
manual and one disk which may 
have Apple on one side and TRS-8Q 
on the other. If you don't have any 
use for the other computer version, 
format it and store your characters 
on it. 


‘Brynhild is just another 


treasure number’ 


| have one reservation — the 
ending. Brynhild is just another 
treasure number, and all the treasures 
are converted to gold Royals at the 
Innkeepers. Brynhild is worthless so 
maybe you should leave her to her 
beauty sleep, and “G’et the melted 
armour or maybe | will leave the 
choice to you. A very good game 
and if you like the style there are two 


expansion kits, (1) The Keys. of 
Acheron and (2) Danger in 
Drindisti. O 
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WORM IN THE APPLE 


Worm in the Apple 


ill some kind gentleman at 
WV the stately pleasure dome in 

Ryde please explain to this 
lowly creature what, precisely, is hap- 
pening to the Apple Ile? This worm 
was allowed sight of a letter that had 
emanated from the highest levels 
saying, in essence, that all Apple Iles 
were sold out and not to hold your 
breath as there wouldn't be any avail- 
able until next February. 

A probing journalist — are there 
any other kind? — for a newspaper 
that shall be nameless, “The Aus- 
tralian’, telephoned and asked how 
could this be? How could Apple sell 
out of their best seller? 

How, indeed? 

Back came the strangest answer. 

First it was pointed out that Aus- 
tralian Apples are made in Ireland. 
secondly, the Irish had been on 
holiday. Third, there had been a shor- 
tage but the drought had been 
relieved by an airfreight shipment of 
some 1,609 machines. Fourth, Apple 
Iles with European configuration 
were now arriving in large quantities 
and another letter was being sent to 
retailers telling them to sell as many 
as they liked as stocks were more 
than adequate. 

Which brings to mind a strange 
Story. 

Once upon a time the Duke of 
Wellington was standing on the 
steps of the Reform Club in London 
when a man approached him and 
said, “Mr Smith, | believe.” 

The Iron Duke raised an eyebrow 
and replied, “Sir, if you can believe 
that you can believe anything.” 

| don’t Know why | have just 
thought of that story. It just flashed 
into my mind. 


Bits not bytes 


It is not for a lowly worm to point 
the finger of shame at any senior 
executive at Apple. By and large they 
are a fairly decent bunch, even 
though they do make their own suits. 
But | really feel it would be helpful for 
me to point out that there is a dif- 
ference between bits and bytes, and 
that the new chips in the Macintosh 
are 256K bit chips. Not 256K byte 
chips. Honest, guvnor. | only men- 
tion it to be helpful. 


Sam sung blue 


If you have an Apple Ile and look 
with great care at the monitor, you 
will see it is built in South Korea by a 
company called Samsung. Personal- 
ly, | think the monitors are the least 
well built part of the Apple computer, 
but it is not for a lowly worm to com- 
ment on matters like that. 

However, my South Korean worm 
friend working off the island of Cheju 
(he’s rather keen on the pearl divers 
there) tells me this amazing tale. 
Apparently an American company 
that makes a disk drive called Tan- 
don have just taken considerable 
umbrage over the fact that their 
machines are apparently being 
pirated in South Korea. They have 
therefore slapped law suits on all 
and sundry and are claiming 
damages around the $1909 million 
mark — give or take the odd dollar. 

And named in the suit is a major 
Korean computer manufacturer. 
Although | have no musical talent I’m 


working on a song which goes “Sam 
Sung blue, everybody knows one...” 

Who knows, it may make the Top 
Twenty. 


Will the pop up pop up? 


What then is happening with the 
pop-up screen for the Apple llc? 
There is a worm in Cupertino - a 
statement that has been made oft 
before — who supplies me with infor- 
mation. And the word from my 
transpacific Deep Throat is that 
Apple are holding back because the 
screen simply is not good enough 
for release. 

| could have told them that at the 
beginning. 

Because | know of no Liquid Crys- 
tal Display which is of any use for 
anything except a wrist watch. Those 
who still do not believe this lowly 
worm, please look at the incredibly 
expensive Hewlett Packard Lap 
Computer which has the best LCD 
display yet seen in captivity — but the 
display is still not much good. 

| have the strongest doubts that 
Apple will ever release the pop up 
screen in Liquid Crystal Display 
form. O 


UP kk. 
DATA 


YOUR DISKS 


EDD Is the most powerful disk duplicator 
available for your Apple™ computer. 
Unlike the copycards, which only copy 
single load programs, EDD backs up 
your entire disk. EOD can back up more 
protected software than all other copy 
programs or copycards put together. 


Since EDO ts automatic, you will-no 
longer have to change parameters to 
duplicate most disks, although every 
parameter 1s fully documented In our 


$98.95 


extensive manual. We also provide up- 


dated EDD program lists. 


UTILITY SOFTWARE 


83 Hall Street, Bondi Beach NSW 2026. 
Telephone (02) 302105. 


Was Rembrandt 
really an Australian? 


It's easy to see Why one American reviewer got our all-Australian software confused with a 
European masterpiece. Our programs have been praised in England and pirated in Taiwan. 
In Australia, they've been used and used and used. We want to make more all-Australian 
programs that are solidly useful. 


The success we've had is enabling us to do just that. We have been forming a team of talented 
programmers whose sole aim is quality. We're preparing a series of masterpieces. None of 
them will be paintings, all of them will be the finest programs for the finest computers. They 
will all bear the name Zardax, as your guarantee of quality. 


Whats all this got to do with Rembrandt? Read on. 


— “this word processor is a piece of cake to use.” Infoworld 22/2/82 

— ‘superbly easy to use, quick, convenient.”’ PCAL Report Dec 83 

— ‘In many ways better than a dedicated word processor.” The Australian 31/3/84 
— ‘if word processing is an art, Zardax is a Rembrandt.” In-Cider March 83 

— ‘highly recommended.” Softalk Jan 84 

— ‘“Zardax wins praise for being well-nigh bulletproof.’ Your Computer April 84 


Zardax’ 


Zardax Word Processor I — for Dos. 3.3 on the Apple II computer 
Zardax Word Processor II— for ProDOS on the Apple //e and //c 
Zardax Word Processor IIF for the Apple /// computer 

Zardax WRITER — a new generation program for the IBM PC 


16 Carrara Street, 
COMPUTER Eivigawrw.weer 


P.O. Box 397, 


SOLUTIONS @iiixeirusew sr 


(07) 349 9883 


Publishers of Zardax software 


introducing 


a Teacher You Can 
Give to Your 


For the first time in 
Australia, quality edu- 
cational courseware is — 
available for your Apple IIE or 
your Apple II Plus. Control Data PLATO" 
is proud to announce that from December 
lst, new lessons from the vast PLATO 
computer based education library will be 
available for your Apple micro. 

Control Data PLATO computer-based 
education, recognised as a world leader in 
educational software, is a highly inter- 
active system of self-paced, one-to-one in- 
struction. Developed over 20 years, it has 
been thoroughly tested and proven in busi- 
ness, industry, and the academic commu- 
nity. PLATO lessons are designed 
and programmed to motivate and di- 
rect students as well as helping 
them develop a sense of ac- 
complishment and personal 
progress. 

For example, the course 
titled Computer Literacy pro- 
vides the foundation for simple 
programming as well as giving 
a brief introduction to the uses Ewe 
of computers in today’s society. 
There are lessons in building 


p 


vocabulary in French, Ger- 
lp ‘man and Spanish as well 


as lessons in Physics, 
Fractions, Decimals and Basic Number 
Facts. 

Today, more than ever before, all 
members of society need to learn. PLATO 
computer-based education is designed and 
paced for the individual. This means easier 
learning with infinite patience and person- 
alization. 

As traditional education methods be- 
come progressively more costly and less 
efficient you owe it to yourself to bring the 
power of PLATO learning to your Apple. 

If you would like to be on our mailing 
_ list for future information on 
_ PLATO Courseware for your 
_ Apple, please fill in and mail the 


PLATO . 


Changing How The World Learns. 


. : Mail to: Marketing Manager, 
EDUCATION SERVICES, CONTROL DATA AUSTRALIA PTY. LTD., | 


493 St. Kilda Road, Melbourne 3004. Ee S) | 


ADDRESS se this sshicdenda abate dea wid enats CONTROL 


~~, ee STATE ....04. POSTCODE ....... DATA = 


Burrows Doble Lawrence CDA/616 


